UcmUcsiConnectorCollectionCreate-Funktion (ucmucsippm.h)
Erstellt ein Verbinderauflistungsobjekt 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 WdfDeviceCreateempfangen 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 für das neue Connectorauflistungsobjekt empfängt.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls kann diese Methode einen geeigneten NTSTATUS- Wert zurückgeben.
Bemerkungen
Das Auflistungsobjekt ist erforderlich, um ein PPM-Objekt (Platform Policy Manager) zu erstellen. Der Clienttreiber erstellt das Objekt durch Aufrufen von UcmUcsiPpmCreate. Der Treiber darf [UcmUcsiConnectorCollectionCreate] nach UcmUcsiPpmCreate nicht aufrufen, da es keine Auswirkungen auf das bereits vorhandene PPM-Objekt hätte.
Das Connectorauflistungsobjekt wird 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 |
|---|---|
| Minimale KMDF-Version | 1.27 |
| Mindest-UMDF-Version | N/A |
| Header- | ucmucsippm.h (include UcmUcsiCx.h) |
| Library | UcmUcsiCxStub.lib |
| IRQL- | PASSIVE_LEVEL |