Funzione WdfDeviceAllocAndQueryInterfaceProperty (wdfdevice.h)

Articolo
02/07/2025

[Si applica solo a UMDF]

Il metodo WdfDeviceAllocAndQueryInterfaceProperty alloca un buffer e recupera una proprietà dell'interfaccia dispositivo specificata.

Sintassi

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
);

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[in] PropertyData

Puntatore a una struttura WDF_DEVICE_INTERFACE_PROPERTY_DATA che identifica la proprietà dell'interfaccia del dispositivo da recuperare.

[in] PoolType

Enumeratore POOL_TYPEtipizzato che specifica il tipo di memoria da allocare.

[in, optional] PropertyMemoryAttributes

Puntatore a una struttura di WDF_OBJECT_ATTRIBUTES allocata dal chiamante che descrive gli attributi dell'oggetto oggetto per l'oggetto memoria allocato dalla funzione. Questo parametro è facoltativo e può essere WDF_NO_OBJECT_ATTRIBUTES.

[out] PropertyMemory

Puntatore a un WDFMEMORYposizione tipizzata che riceve un handle per un oggetto memoria framework.

[out] Type

Puntatore a un DEVPROPTYPEvariabile tipizzata che, in caso di restituzione, identifica il tipo di dati della proprietà contenuti in PropertyMemory.

Valore restituito

Se il metodo WdfDeviceAllocAndQueryInterfaceProperty non rileva errori, restituisce STATUS_SUCCESS. I valori restituiti aggiuntivi includono:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	Uno dei parametri non è corretto.

Il metodo potrebbe restituire altri valori NTSTATUS .

Osservazioni

Il metodo WdfDeviceAllocAndQueryInterfaceProperty determina la quantità di memoria necessaria per contenere la proprietà dell'interfaccia del dispositivo richiesta. Alloca memoria sufficiente per contenere i dati e restituisce un handle a un oggetto memoria framework che descrive la memoria allocata. Per accedere ai dati, il driver può chiamare WdfMemoryGetBuffer.

Per informazioni sui metodi correlati, vedere Accesso al modello di proprietà del dispositivo unificato.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8.1
piattaforma di destinazione	Universale
versione minima di UMDF	2.0
intestazione	wdfdevice.h (include Wdf.h)
libreria	WUDFx02000.lib
dll	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

Vedere anche

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAssignInterfaceProperty

WdfDeviceQueryInterfaceProperty

Condividi tramite