UcmUcsiPpmCreate, fonction (Ucmucsippm.h)

Article
02/07/2025

Crée un objet Platform Policy Manager (PPM).

Syntaxe

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

Paramètres

[in] WdfDevice

Handle vers un objet d’appareil framework reçu par le pilote client lors de l’appel précédent à WdfDeviceCreate.

[in] Config

Pointeur vers une structure UCMUCSI_PPM_CONFIG fournie par l’appelant qui est initialisée en appelant UCMUCSI_PPM_CONFIG_INIT. Le membre ConnectorCollectionHandle doit être défini sur le handle récupéré dans un appel précédent pour UcmUcsiConnectorCollectionCreate.

[in] Attributes

Pointeur vers une structure WDF_OBJECT_ATTRIBUTES fournie par l’appelant qui contient des attributs pour le nouvel objet de collection de connecteurs. Ce paramètre est facultatif et peut être WDF_NO_OBJECT_ATTRIBUTES.

[out] PPMObject

Pointeur vers un emplacement qui reçoit un handle vers le nouvel objet PPM.

Valeur de retour

Retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette méthode peut retourner une valeur NTSTATUS appropriée.

Remarques

Le pilote client est censé appeler UcmUcsiPpmCreate à partir de la fonction de rappel EVT_WDF_DEVICE_PREPARE_HARDWARE.

La structure transmise dans configuration contient Type-C informations de connecteur nécessaires à la création de connecteurs avec l’extension de classe de connecteur USB Type-C (UcmCx) à l’aide de UcmConnectorCreate et qui ne sont pas obtenues à partir de PPM via des commandes UCSI telles que GetCapability ou GetConnectorCapability.

La structure Config contient également des ID de connecteur, requis pour le mappage un-à-un entre les connecteurs USB Type-C et les ports USB.

L’objet PPM est également un WDFOBJECT et crée une association un-à-un avec le handle WDFDEVICE fourni par le pilote client.

L’objet PPM est parenté du WDFOBJECT même lorsque UcmUcsiPpmCreate est appelé en passant WDF_NO_ATTRIBUTES. La durée de vie de l’objet est gestionnaire par l’infrastructure.

Exigences

Exigence	Valeur
version minimale de KMDF	1.27
version minimale de UMDF	N/A
d’en-tête	Ucmucsippm.h (include UcmUcsiCx.h)
bibliothèque	UcmUcsiCxStub.lib
IRQL	PASSIVE_LEVEL

Partager via