UcmUcsiConnectorCollectionCreate-Funktion (ucmucsippm.h)
Erstellt ein Connectorauflistungsobjekt mit UcmUcsiCx.
Syntax
NTSTATUS UcmUcsiConnectorCollectionCreate(
[in] WDFDEVICE WdfDevice,
[in] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] UCMUCSI_CONNECTOR_COLLECTION *ConnectorCollection
);
Parameter
[in] WdfDevice
Ein Handle für ein Framework-Geräteobjekt, das der Clienttreiber im vorherigen Aufruf von WdfDeviceCreate empfangen hat.
[in] Attributes
Ein Zeiger auf eine vom Aufrufer bereitgestellte WDF_OBJECT_ATTRIBUTES-Struktur , die Attribute für das neue Connectorauflistungsobjekt enthält. Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden.
[out] ConnectorCollection
Ein Zeiger auf eine Position, die ein Handle auf das neue Connectorauflistungsobjekt empfängt.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls kann diese Methode einen entsprechenden NTSTATUS-Wert zurückgeben.
Hinweise
Das Auflistungsobjekt ist zum Erstellen eines PPM-Objekts (Platform Policy Manager) erforderlich. Der Clienttreiber erstellt das Objekt durch Aufrufen von UcmUcsiPpmCreate. Der Treiber darf [UcmUcsiConnectorCollectionCreate] nach UcmUcsiPpmCreate nicht aufrufen, da er keine Auswirkungen auf das bereits vorhandene PPM-Objekt hätte.
Das Connectorauflistungsobjekt ist dem WDFOBJECT übergeordnet, auch wenn UcmUcsiConnectorCollectionCreate aufgerufen wird, indem WDF_NO_ATTRIBUTES übergeben wird. Die Lebensdauer des Objekts wird vom Framework verwaltet.
Anforderungen
Anforderung | Wert |
---|---|
KMDF-Mindestversion | 1,27 |
UMDF-Mindestversion | – |
Kopfzeile | ucmucsippm.h (include UcmUcsiCx.h) |
Bibliothek | UcmUcsiCxStub.lib |
IRQL | PASSIVE_LEVEL |