Contents

newUserClient

Creates a connection for a non kernel client.

Declaration

virtual IOReturn newUserClient(
 task_towningTask,
 void *securityID, 
 UInt32type,
 OSDictionary *handler, 
 IOUserClient **properties );

Parameters

  • owningTask:

    The Mach task of the client thread in the process of opening the user client. Note that in macOS, each process is based on a Mach task and one or more Mach threads. For more information on the composition of a Mach task and its relationship with Mach threads, see Devlink 1718884.

  • securityID:

    A token representing the access level for the task.

  • type:

    A constant specifying the type of connection to be created, specified by the caller of 1514515 Ioserviceopen and interpreted only by the family.

  • handler:

    An instance of an IOUserClient object to represent the connection, which will be released when the connection is closed, or zero if the connection was not opened.

  • properties:

    A dictionary of additional properties for the connection.

Return Value

A return code to be passed back to the caller of IOServiceOpen.

Overview

A non kernel client may request a connection be opened via the IOServiceOpen library function, which will call this method in an IOService object. The rules and capabilities of user level clients are family dependent, and use the functions of the IOUserClient class for support. IOService's implementation returns kIOReturnUnsupported, so any family supporting user clients must implement this method.

See Also

Miscellaneous