UcmUcsiConnectorCollectionCreate-Funktion (ucmucsippm.h)

  • Artikel

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

Weitere Informationen

WdfDeviceCreate

WDF_OBJECT_ATTRIBUTES

UcmUcsiPpmCreate

UcmUcsiConnectorCollectionAddConnector