Funzione WdfDeviceAllocAndQueryInterfaceProperty (wdfdevice.h)

Articolo
03/05/2024

[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_TYPE tipizzato che specifica il tipo di memoria da allocare.

[in, optional] PropertyMemoryAttributes

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

[out] PropertyMemory

Puntatore a una posizione tipizzata WDFMEMORY che riceve un handle a un oggetto memoria framework.

[out] Type

Puntatore a una variabile tipizzata DEVPROPTYPE che, in caso di restituzione, identifica il tipo di dati delle 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.

Commenti

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 del 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à dispositivo unificato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1
Piattaforma di destinazione	Universale
Versione UMDF minima	2,0
Intestazione	wdfdevice.h (includere Wdf.h)
Libreria	WUDFx02000.lib
DLL	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

Vedi anche

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAssignInterfaceProperty

WdfDeviceQueryInterfaceProperty

Condividi tramite