WdfDeviceAllocAndQueryInterfaceProperty, fonction (wdfdevice.h)

Article
02/07/2025

[S’applique uniquement à UMDF]

La méthode WdfDeviceAllocAndQueryInterfaceProperty alloue une mémoire tampon et récupère une propriété d’interface d’appareil spécifiée.

Syntaxe

NTSTATUS WdfDeviceAllocAndQueryInterfaceProperty(
  [in]           WDFDEVICE                           Device,
  [in]           PWDF_DEVICE_INTERFACE_PROPERTY_DATA PropertyData,
  [in]           POOL_TYPE                           PoolType,
  [in, optional] PWDF_OBJECT_ATTRIBUTES              PropertyMemoryAttributes,
  [out]          WDFMEMORY                           *PropertyMemory,
  [out]          PDEVPROPTYPE                        Type
);

Paramètres

[in] Device

Handle vers un objet d’appareil framework.

[in] PropertyData

Pointeur vers une structure WDF_DEVICE_INTERFACE_PROPERTY_DATA qui identifie la propriété de l’interface d’appareil à récupérer.

[in] PoolType

Énumérateur POOL_TYPE-typé qui spécifie le type de mémoire à allouer.

[in, optional] PropertyMemoryAttributes

Pointeur vers une structure WDF_OBJECT_ATTRIBUTES allouée par l’appelant qui décrit les attributs d’objet pour l’objet mémoire que la fonction alloue. Ce paramètre est facultatif et peut être WDF_NO_OBJECT_ATTRIBUTES.

[out] PropertyMemory

Pointeur vers un WDFMEMORYemplacement typé qui reçoit un handle vers un objet mémoire framework.

[out] Type

Pointeur vers une variable DEVPROPTYPE-typée qui, lors du retour, identifie le type de données de propriété contenues dans PropertyMemory.

Valeur de retour

Si la méthode WdfDeviceAllocAndQueryInterfaceProperty ne rencontre aucune erreur, elle retourne STATUS_SUCCESS. Les valeurs de retour supplémentaires sont les suivantes :

Retourner le code	Description
STATUS_INVALID_PARAMETER	L’un des paramètres est incorrect.

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

Remarques

La méthode WdfDeviceAllocAndQueryInterfaceProperty détermine la quantité de mémoire nécessaire pour contenir la propriété d’interface d’appareil demandée. Il alloue suffisamment de mémoire pour contenir les données et retourne un handle à un objet de mémoire de framework qui décrit la mémoire allouée. Pour accéder aux données, votre pilote peut appeler WdfMemoryGetBuffer.

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

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8.1
plateforme cible	Universel
version minimale de UMDF	2.0
d’en-tête	wdfdevice.h (include Wdf.h)
bibliothèque	WUDFx02000.lib
DLL	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

Voir aussi

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAssignInterfaceProperty

WdfDeviceQueryInterfaceProperty

Partager via