WdfFdoInitAllocAndQueryPropertyEx, fonction (wdffdo.h)

Article
03/22/2025

[S’applique à KMDF et UMDF]

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

Syntaxe

NTSTATUS WdfFdoInitAllocAndQueryPropertyEx(
  [in]           PWDFDEVICE_INIT           DeviceInit,
  [in]           PWDF_DEVICE_PROPERTY_DATA DeviceProperty,
  [in]           POOL_TYPE                 PoolType,
  [in, optional] PWDF_OBJECT_ATTRIBUTES    PropertyMemoryAttributes,
  [out]          WDFMEMORY                 *PropertyMemory,
  [out]          PDEVPROPTYPE              Type
);

Paramètres

[in] DeviceInit

Pointeur vers une structure WDFDEVICE_INIT que le pilote a obtenue à partir de sa fonction de rappel EvtDriverDeviceAdd.

[in] DeviceProperty

Pointeur vers une structure WDF_DEVICE_PROPERTY_DATA qui identifie la propriété de l’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 emplacement typé WDFMEMORY qui reçoit un handle vers un objet mémoire de framework.

[out] Type

Pointeur vers une variable DEVPROPTYPE. Si la méthode réussit, lors du retour de ce paramètre contient la valeur de type de propriété des données de propriété stockées dans PropertyMemory.

Valeur de retour

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

Code de retour	Description
STATUS_INVALID_PARAMETER	La valeur DeviceProperty spécifiée n’est pas valide.

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

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Remarques

La méthode WdfFdoInitAllocAndQueryPropertyEx 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.

Le pilote peut appeler WdfFdoInitAllocAndQueryPropertyEx uniquement avant d’appeler WdfDeviceCreate. Pour plus d’informations sur l’appel WdfDeviceCreate, consultez Création d’un objet d’appareil Framework.

Après avoir appelé WdfDeviceCreate, un pilote peut obtenir des informations de propriété d’appareil en appelant WdfDeviceAllocAndQueryPropertyEx.

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

Spécifications

Besoin	Valeur
plateforme cible	Universel
version minimale de KMDF	1.13
version minimale de UMDF	2.0
En-tête	wdffdo.h (include Wdf.h)
Bibliothèque	Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL

Voir aussi

WdfFdoInitAllocAndQueryProperty

Partager via