WDF_DRIVER_CONFIG 構造体 (wdfdriver.h)

[アーティクル]
02/27/2024

[KMDF と UMDF に適用]

WDF_DRIVER_CONFIG構造体は、 WdfDriverCreate への入力パラメーターです。

構文

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;

メンバー

Size

この構造体のサイズ (バイト単位)。

EvtDriverDeviceAdd

ドライバーの EvtDriverDeviceAdd コールバック関数へのポインター。

EvtDriverUnload

ドライバーの EvtDriverUnload コールバック関数へのポインター。

DriverInitFlags

ドライバー初期化フラグを識別する 1 つ以上の WDF_DRIVER_INIT_FLAGS型指定された値のビットごとの OR。

DriverPoolTag

(KMDF バージョン 1.5 以降)。フレームワークがドライバーのすべてのプール割り当てに割り当てるドライバー定義プールタグ。デバッガーには、このタグが表示されます。プールタグの指定の詳細については、次の「備考」セクションを参照してください。

注釈

ドライバーは、必要に応じて、フレームワークがドライバーのすべてのプール割り当てに割り当てるプールタグを指定できます。ドライバーは通常、最大 4 文字の文字列を、一重引用符で区切って逆の順序で指定します (例: 'dcba')。タグ内の各文字の ASCII 値は、0 から 127 の間である必要があります。

DriverPoolTag が 0 の場合、フレームワークはドライバーのカーネルモードサービス名の最初の 4 文字を使用して既定のプールタグを作成します。サービス名が "WDF" で始まる場合 (名前は大文字と小文字は区別されず、引用符は含まれません)、次の 4 文字が使用されます。使用できる文字数が 4 文字未満の場合は、"FxDr" が使用されます。

WDF_DRIVER_CONFIG構造体を初期化するには、ドライバーが WDF_DRIVER_CONFIG_INIT を呼び出す必要があります。