WdfPdoRetrieveIdentificationDescription, fonction (wdfpdo.h)

Article
02/27/2024

[S’applique à KMDF uniquement]

La méthode WdfPdoRetrieveIdentificationDescription récupère la description d’identification associée à un objet d’appareil d’infrastructure spécifié.

Syntaxe

NTSTATUS WdfPdoRetrieveIdentificationDescription(
  [in]      WDFDEVICE                                    Device,
  [in, out] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);

Paramètres

[in] Device

Handle vers un objet d’appareil d’infrastructure qui représente l’objet d’appareil physique (PDO) de l’appareil.

[in, out] IdentificationDescription

Pointeur vers une mémoire tampon allouée par l’appelant qui recevra la description de l’identification. La description de l’identification doit contenir une structure WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER .

Valeur retournée

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

Code de retour	Description
STATUS_INVALID_PARAMETER	Le handle d’appareil ne représente pas un PDO.
STATUS_INVALID_DEVICE_REQUEST	Le handle d’appareil ne représente pas un appareil qui a été énuméré dynamiquement, ou si la structure WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER ne contient pas la taille de mémoire tampon correcte.

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

Un bogue système case activée se produit si le pilote fournit un handle d’objet non valide.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
En-tête	wdfpdo.h (inclure Wdf.h)
Bibliothèque	Wdf01000.sys (consultez Gestion des versions de la bibliothèque d’infrastructure).)
IRQL	<= DISPATCH_LEVEL
Règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfPdoRetrieveAddressDescription

Partager via