Contents

nameMatching(const OSString *, OSDictionary *)

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

Declaration

static OSDictionary * nameMatching(
 const OSString *name, 
 OSDictionary *table = 0 );

Parameters

  • name:

    The service's name, as an OSString (which includes OSSymbol). Name matching is successful on IOService objects that respond successfully to the IORegistryEntry::compareName method.

  • table:

    If zero, nameMatching creates a matching dictionary and returns 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 object is based on its name. nameMatching creates a matching dictionary that specifies any IOService object which responds successfully to the IORegistryEntry::compareName method. 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