WdfPdoRetrieveIdentificationDescription, fonction (wdfpdo.h)
[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 |
---|---|
|
Le handle d’appareil ne représente pas un PDO. |
|
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour