WdfPdoUpdateAddressDescription, fonction (wdfpdo.h)

Article
02/29/2024

[S’applique uniquement à KMDF]

La méthode WdfPdoUpdateAddressDescription met à jour la description d’adresse associée à un objet d’appareil framework spécifié.

Syntaxe

NTSTATUS WdfPdoUpdateAddressDescription(
  [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) d’un appareil.

[in, out] AddressDescription

Pointeur vers une mémoire tampon allouée à l’appelant qui contient une description d’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
STATUS_INVALID_PARAMETER	Le handle d’appareil ne représente pas un AOP.
STATUS_INVALID_DEVICE_REQUEST	Le handle d’appareil ne représente pas un appareil qui a été énuméré dynamiquement ou si le membre Size de la structure WDF_CHILD_ADDRESS_DESCRIPTION_HEADER spécifiée ne correspond pas à la taille de la description d’adresse existante de l’appareil.

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

WdfPdoRetrieveAddressDescription

Partager via