WdfPdoRetrieveAddressDescription, fonction (wdfpdo.h)
[S’applique uniquement à KMDF]
La méthode WdfPdoRetrieveAddressDescription récupère la description d’adresse associée à un objet d’appareil d’infrastructure spécifié.
Syntaxe
NTSTATUS WdfPdoRetrieveAddressDescription(
[in] WDFDEVICE Device,
[in, out] PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER AddressDescription
);
Paramètres
[in] Device
Handle d’un objet d’appareil framework qui représente l’objet d’appareil physique (PDO) de l’appareil.
[in, out] AddressDescription
Pointeur vers une mémoire tampon allouée à l’appelant qui recevra la description de l’adresse. La description de l’adresse doit contenir une structure WDF_CHILD_ADDRESS_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 AOP. |
|
Le handle d’appareil ne représente pas un appareil qui a été énuméré dynamiquement. |
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 de version 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_ADDRESS_DESCRIPTION_HEADER_INIT
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