WdfPdoInitAssignContainerID, fonction (wdfpdo.h)

Article
22/03/2025

[S’applique uniquement à KMDF]

La méthode WdfPdoInitAssignContainerID met à jour l’ID de conteneur d’un appareil enfant.

Syntaxe

NTSTATUS WdfPdoInitAssignContainerID(
  [in] PWDFDEVICE_INIT  DeviceInit,
  [in] PCUNICODE_STRING ContainerID
);

Paramètres

[in] DeviceInit

Pointeur vers une structure WDFDEVICE_INIT.

[in] ContainerID

Pointeur vers une structure UNICODE_STRING qui contient une chaîne d’ID de conteneur. Le pilote peut allouer la mémoire tampon de la chaîne à partir du pool paginé.

Valeur de retour

Si l’opération réussit, la méthode retourne STATUS_SUCCESS. Les valeurs de retour supplémentaires sont les suivantes :

Code de retour	Description
STATUS_INVALID_DEVICE_REQUEST	Le pilote initialise un FDO au lieu d’un PDO.
STATUS_INSUFFICIENT_RESOURCES	Le pilote n’a pas pu allouer d’espace pour stocker la chaîne d’ID de conteneur.

La méthode peut également retourner d’autres valeurs NTSTATUS .

Remarques

Pour plus d’informations sur les ID de conteneur, consultez chaînes d’identification d’appareil.

Le pilote doit appeler WdfPdoInitAssignContainerID avant d’appeler WdfDeviceCreate. Pour plus d’informations sur l’appel WdfDeviceCreate, consultez Création d’un objet d’appareil Framework.

Exemples

L’exemple de code suivant initialise une structure UNICODE_STRING, stocke une chaîne Unicode dans la structure, puis inscrit la chaîne Unicode comme ID de conteneur de l’appareil.

UNICODE_STRING containerId = {0}; 

RtlInitUnicodeString(
                     &containerId,
                     strContainerId //Unicode string for container ID
                     );
status = WdfPdoInitAssignContainerID(
                                     pDeviceInit,
                                     &containerId
                                     );

Spécifications

Besoin	Valeur
plateforme cible	Universel
version minimale de KMDF	1.9
En-tête	wdfpdo.h (include Wdf.h)
Bibliothèque	Wdf01000.sys (voir Versioning de la bibliothèque Framework.)
IRQL	PASSIVE_LEVEL
règles de conformité DDI	DriverCreate(kmdf)