Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
[S’applique uniquement à KMDF]
La méthode WdfPdoRetrieveIdentificationDescription récupère la description d’identification associée à un objet d’appareil framework 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 framework qui représente l’objet d’appareil physique de l’appareil (PDO).
[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 de retour
Si l’opération réussit, la fonction retourne STATUS_SUCCESS. Les valeurs de retour supplémentaires sont les suivantes :
| Code de retour | Description |
|---|---|
|
Le handle Device ne représente pas de PDO. |
|
Le handle 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.
Une vérification des bogues système se produit si le pilote fournit un handle d’objet non valide.
Spécifications
| Besoin | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| En-tête | wdfpdo.h (include Wdf.h) |
| Bibliothèque | Wdf01000.sys (voir Versioning de la bibliothèque Framework.) |
| IRQL | <= DISPATCH_LEVEL |
| règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |