WdfDeviceAssignProperty, fonction (wdfdevice.h)

Article
08/08/2023

[S’applique à KMDF et UMDF]

La méthode WdfDeviceAssignProperty modifie le paramètre actuel d’une propriété d’appareil.

Syntaxe

NTSTATUS WdfDeviceAssignProperty(
  [in]           WDFDEVICE                 Device,
  [in]           PWDF_DEVICE_PROPERTY_DATA DeviceProperty,
  [in]           DEVPROPTYPE               Type,
  [in]           ULONG                     Size,
  [in, optional] PVOID                     Data
);

Paramètres

[in] Device

Handle pour un objet d’appareil d’infrastructure.

[in] DeviceProperty

Pointeur vers une structure de WDF_DEVICE_PROPERTY_DATA qui identifie la propriété d’appareil à modifier.

[in] Type

Variable de type DEVPROPTYPE qui spécifie le type des données stockées dans Data.

[in] Size

Taille, en octets, de la mémoire tampon pointée par data.

[in, optional] Data

Pointeur vers une mémoire tampon allouée à l’appelant qui contient les données de propriété de l’appareil. Définissez ce paramètre sur NULL pour supprimer la propriété spécifiée.

Valeur retournée

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

Code de retour	Description
STATUS_INVALID_PARAMETER	L’un des paramètres est incorrect.

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

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

Remarques

Vous pouvez utiliser WdfDeviceAssignProperty pour modifier le paramètre de toute propriété exposée via le modèle de propriété unifié.

Pour plus d’informations sur les méthodes associées, consultez Accès au modèle de propriété d’appareil unifié.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.13
Version UMDF minimale	2.0
En-tête	wdfdevice.h (inclure Wdf.h)
Bibliothèque	Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL	APC_LEVEL

Voir aussi

WdfDeviceAssignInterfaceProperty

Partager via