Funzione WdfFdoInitAllocAndQueryPropertyEx (wdffdo.h)

Articolo
08/08/2023

[Si applica a KMDF e UMDF]

Il metodo WdfFdoInitAllocAndQueryPropertyEx alloca un buffer e recupera una proprietà del dispositivo specificata.

Sintassi

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

Parametri

[in] DeviceInit

Puntatore a una struttura WDFDEVICE_INIT ottenuta dal driver dalla funzione EvtDriverDeviceAdd callback.

[in] DeviceProperty

Puntatore a una struttura WDF_DEVICE_PROPERTY_DATA che identifica la proprietà 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 DEVPROPTYPE . Se il metodo ha esito positivo, dopo aver restituito questo parametro contiene il valore del tipo di proprietà dei dati della proprietà archiviati in PropertyMemory.

Valore restituito

Se l'operazione ha esito positivo, WdfFdoInitAllocAndQueryPropertyEx restituisce STATUS_SUCCESS. I valori restituiti aggiuntivi includono:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	Il valore DeviceProperty specificato non è valido.

Il metodo potrebbe restituire altri valori NTSTATUS.

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Commenti

Il metodo WdfFdoInitAllocAndQueryPropertyEx determina la quantità di memoria necessaria per contenere la proprietà dell'interfaccia 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.

Il driver può chiamare WdfFdoInitAllocAndQueryPropertyEx solo prima di chiamare WdfDeviceCreate. Per altre informazioni sulla chiamata a WdfDeviceCreate, vedere Creazione di un oggetto dispositivo Framework.

Dopo aver chiamato WdfDeviceCreate, un driver può ottenere informazioni sulla proprietà del dispositivo chiamando WdfDeviceAllocAndQueryPropertyEx.

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.13
Versione UMDF minima	2,0
Intestazione	wdffdo.h (include Wdf.h)
Libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL

Vedi anche

WdfFdoInitAllocAndQueryProperty

Condividi tramite