struttura WDF_DRIVER_CONFIG (wdfdriver.h)

Articolo
08/08/2023

[Si applica a KMDF e UMDF]

La struttura WDF_DRIVER_CONFIG è un parametro di input per WdfDriverCreate.

Sintassi

typedef struct _WDF_DRIVER_CONFIG {
  ULONG                     Size;
  PFN_WDF_DRIVER_DEVICE_ADD EvtDriverDeviceAdd;
  PFN_WDF_DRIVER_UNLOAD     EvtDriverUnload;
  ULONG                     DriverInitFlags;
  ULONG                     DriverPoolTag;
} WDF_DRIVER_CONFIG, *PWDF_DRIVER_CONFIG;

Members

Size

Dimensione, in byte, della struttura.

EvtDriverDeviceAdd

Puntatore alla funzione di callback EvtDriverDeviceAdd di un driver.

EvtDriverUnload

Puntatore alla funzione di callback EvtDriverUnload di un driver.

DriverInitFlags

OR bit per bit di uno o più valori tipizzati WDF_DRIVER_INIT_FLAGS che identificano i flag di inizializzazione del driver.

DriverPoolTag

(KMDF versioni 1.5 e successive). Tag del pool definito dal driver che il framework assegnerà a tutte le allocazioni del pool del driver. I debugger visualizzano questo tag. Per altre informazioni sulla specifica di un tag di pool, vedere la sezione Osservazioni seguente.

Commenti

Il driver può facoltativamente specificare un tag del pool che il framework assegnerà a tutte le allocazioni del pool del driver. I driver specificano in genere una stringa di caratteri con un massimo di quattro caratteri, delimitati da virgolette singole, in ordine inverso, ad esempio 'dcba'. Il valore ASCII di ogni carattere nel tag deve essere compreso tra 0 e 127.

Se DriverPoolTag è zero, il framework crea un tag del pool predefinito usando i primi quattro caratteri del nome del servizio in modalità kernel del driver. Se il nome del servizio inizia con "WDF" (il nome non fa distinzione tra maiuscole e minuscole e non include le virgolette), vengono usati i quattro caratteri successivi. Se sono disponibili meno di quattro caratteri, viene usato "FxDr".

Per inizializzare una struttura di WDF_DRIVER_CONFIG, i driver devono chiamare WDF_DRIVER_CONFIG_INIT.