UcmUcsiPpmCreate-Funktion (Ucmucsippm.h)

Artikel
02/29/2024

Erstellt ein PPM-Objekt (Platform Policy Manager).

Syntax

NTSTATUS UcmUcsiPpmCreate(
  [in]  WDFDEVICE              WdfDevice,
  [in]  PUCMUCSI_PPM_CONFIG    Config,
  [in]  PWDF_OBJECT_ATTRIBUTES Attributes,
  [out] UCMUCSIPPM             *PPMObject
);

Parameter

[in] WdfDevice

Ein Handle für ein Framework-Geräteobjekt, das der Clienttreiber im vorherigen Aufruf von WdfDeviceCreate empfangen hat.

[in] Config

Ein Zeiger auf eine vom Aufrufer bereitgestellte UCMUCSI_PPM_CONFIG-Struktur , die durch Aufrufen von UCMUCSI_PPM_CONFIG_INIT initialisiert wird. Das ConnectorCollectionHandle-Element muss auf das Handle festgelegt werden, das bei einem vorherigen Aufruf von UcmUcsiConnectorCollectionCreate abgerufen wurde.

[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] PPMObject

Ein Zeiger auf eine Position, die ein Handle auf das neue PPM-Objekt empfängt.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls kann diese Methode einen geeigneten NTSTATUS-Wert zurückgeben.

Hinweise

Es wird erwartet, dass der Clienttreiber UcmUcsiPpmCreate über die EVT_WDF_DEVICE_PREPARE_HARDWARE Rückruffunktion aufruft.

Die in der Konfiguration übergebene Struktur enthält Typ-C-Connectorinformationen, die zum Erstellen von Connectors mit usb Type-C-Connector Class Extension (UcmCx) mithilfe von UcmConnectorCreate erforderlich sind und nicht über UCSI-Befehle wie GetCapability oder GetConnectorCapability von PPM abgerufen werden können.

Die Config-Struktur enthält auch Connector-IDs, die für die 1:1-Zuordnung zwischen USB-Typ-C-Anschlüssen und USB-Anschlüssen erforderlich sind.

Das PPM-Objekt ist ebenfalls ein WDFOBJECT und erstellt eine 1:1-Zuordnung mit dem vom Clienttreiber bereitgestellten WDFDEVICE-Handle.

Das PPM-Objekt wird dem WDFOBJECT übergeordnet, auch wenn UcmUcsiPpmCreate durch Übergeben von WDF_NO_ATTRIBUTES aufgerufen wird. Die Lebensdauer des Objekts wird vom Framework verwaltet.

Anforderungen

Anforderung	Wert
KMDF-Mindestversion	1,27
UMDF-Mindestversion	–
Kopfzeile	Ucmucsippm.h (einschließlich UcmUcsiCx.h)
Bibliothek	UcmUcsiCxStub.lib
IRQL	PASSIVE_LEVEL

Freigeben über