Contents

propertyMatching

Creates a matching dictionary, or adds matching properties to an existing dictionary, that specify an IOService phandle match.

Declaration

static OSDictionary * propertyMatching(
 const OSSymbol *key,
 const OSObject *value, 
 OSDictionary *table = 0 );

Parameters

  • key:

    The service's phandle, as a const UInt32. PHandle matching is successful on IOService objects that respond successfully to the IORegistryEntry method compareName.

  • value:

    The service's phandle, as a const UInt32. PHandle matching is successful on IOService's which respond successfully to the IORegistryEntry method compareName.

  • table:

    If zero, nameMatching will create a matching dictionary and return a reference to it, otherwise the matching properties are added to the specified dictionary.

Return Value

The matching dictionary created, or passed in, is returned on success, or zero on failure.

Overview

A very common matching criteria for IOService is based on its name. nameMatching will create a matching dictionary that specifies any IOService which respond successfully to the IORegistryEntry method compareName. An existing dictionary may be passed in, in which case the matching properties will be added to that dictionary rather than creating a new one.

See Also

Miscellaneous