UcmUcsiPpmCreate-Funktion (Ucmucsippm.h)

Artikel
02/07/2025

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 WdfDeviceCreateempfangen hat.

[in] Config

Ein Zeiger auf eine vom Aufrufer bereitgestellte UCMUCSI_PPM_CONFIG Struktur, die durch Aufrufen von UCMUCSI_PPM_CONFIG_INITinitialisiert wird. Der ConnectorCollectionHandle Member muss auf das Handle festgelegt werden, das in einem vorherigen Aufruf von UcmUcsiConnectorCollectionCreateabgerufen 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 für 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.

Bemerkungen

Der Clienttreiber wird erwartet, UcmUcsiPpmCreate aus der EVT_WDF_DEVICE_PREPARE_HARDWARE Rückruffunktion aufzurufen.

Die in Config übergebene Struktur enthält Type-C Verbindungsinformationen, die zum Erstellen von Connectors mit USB-Type-C Verbindungsklassenerweiterung (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 Verbindungs-IDs, die für die 1:1-Zuordnung zwischen USB-Type-C-Anschlüssen und USB-Anschlüssen erforderlich sind.

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

Das PPM-Objekt wird an das WDFOBJECT angefügt, auch wenn UcmUcsiPpmCreate 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 (einschließlich UcmUcsiCx.h)
Library	UcmUcsiCxStub.lib
IRQL-	PASSIVE_LEVEL

Freigeben über