Funzione UcmUcsiPpmCreate (Ucmucsippm.h)

Articolo
08/07/2023

Crea un oggetto Platform Policy Manager (PPM).

Sintassi

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

Parametri

[in] WdfDevice

Handle per un oggetto dispositivo framework ricevuto dal driver client nella chiamata precedente a WdfDeviceCreate.

[in] Config

Puntatore a una struttura di UCMUCSI_PPM_CONFIG fornita dal chiamante inizializzata chiamando UCMUCSI_PPM_CONFIG_INIT. Il membro ConnectorCollectionHandle deve essere impostato sull'handle recuperato in una chiamata precedente a UcmUcsiConnectorCollectionCreate.

[in] Attributes

Puntatore a una struttura di WDF_OBJECT_ATTRIBUTES fornita dal chiamante che contiene attributi per il nuovo oggetto raccolta connettori. Questo parametro è facoltativo e può essere WDF_NO_OBJECT_ATTRIBUTES.

[out] PPMObject

Puntatore a una posizione che riceve un handle per il nuovo oggetto PPM.

Valore restituito

Restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo può restituire un valore NTSTATUS appropriato.

Commenti

Il driver client deve chiamare UcmUcsiPpmCreate dalla funzione di callback EVT_WDF_DEVICE_PREPARE_HARDWARE .

La struttura passata in Config contiene informazioni sul connettore Type-C necessarie per la creazione di connettori con estensione della classe del connettore USB Type-C (UcmCx) tramite UcmConnectorCreate e non sono recuperabili da PPM tramite comandi UCSI, ad esempio GetCapability o GetConnectorCapability.

La struttura Config contiene anche gli ID connettore, necessari per il mapping uno-a-uno tra i connettori USB Type-C e le porte USB.

L'oggetto PPM è anche un WDFOBJECT e crea un'associazione uno-a-uno con l'handle WDFDEVICE fornito dal driver client.

L'oggetto PPM viene padre di WDFOBJECT anche quando UcmUcsiPpmCreate viene chiamato passando WDF_NO_ATTRIBUTES. La durata dell'oggetto è gestita dal framework.

Requisiti

Requisito	Valore
Versione KMDF minima	1.27
Versione UMDF minima	N/D
Intestazione	Ucmucsippm.h (include UcmUcsiCx.h)
Libreria	UcmUcsiCxStub.lib
IRQL	PASSIVE_LEVEL

Condividi tramite