WDF_IO_TYPE_CONFIG 構造体 (wdfdevice.h)

  • [アーティクル]

[KMDF と UMDF に適用]

WDF_IO_TYPE_CONFIG構造体は、読み取り要求と書き込み要求、およびデバイス I/O 制御要求に対するドライバーの優先バッファー アクセス方法を指定します。

構文

typedef struct _WDF_IO_TYPE_CONFIG {
  ULONG              Size;
  WDF_DEVICE_IO_TYPE ReadWriteIoType;
  WDF_DEVICE_IO_TYPE DeviceControlIoType;
  ULONG              DirectTransferThreshold;
} WDF_IO_TYPE_CONFIG, *PWDF_IO_TYPE_CONFIG;

メンバー

Size

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

ReadWriteIoType

Kmdf ドライバーが読み取り要求と書き込み要求用に受信したデータ バッファーにアクセスするために使用するメソッドを識別する、 WDF_DEVICE_IO_TYPE型の列挙子。

Umdf ドライバーが読み取り要求と書き込み要求のデータ バッファーにアクセスするために使用するメソッドを識別する、 WDF_DEVICE_IO_TYPE型指定の列挙子。 有効な値には 、WdfDeviceIoBuffered と WdfDeviceIoDirect が含まれます。

DeviceControlIoType

このメンバーは KMDF には適用されません。

Umdf IOCTL 要求のデータ バッファーにドライバーが使用するメソッドを識別する、 WDF_DEVICE_IO_TYPE型の列挙子。 有効な値には 、WdfDeviceIoBuffered と WdfDeviceIoDirect が含まれます。

DirectTransferThreshold

このメンバーは KMDF には適用されません。

Umdf フレームワークがデバイスに直接 I/O を使用する最小のバッファー サイズをバイト単位で指定する省略可能な値。 たとえば、 DirectTransferThreshold を 12288 に設定して、12 キロバイト未満のすべてのバッファーに対してバッファー I/O を使用し、12 キロバイト以上のバッファーには直接 I/O を使用する必要があることを示します。 フレームワークでは最適なパフォーマンスを提供する設定が使用されるため、通常、この値を指定する必要はありません。

注釈

WDF_IO_TYPE_CONFIG構造体は、WdfDeviceInitSetIoTypeEx メソッドへの入力として使用されます。

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

UMDF バージョン 2.0 以降を使用してドライバーを作成する場合は、優先バッファー アクセス方法の指定の詳細については、「 UMDF ドライバーでのバッファー アクセス方法の管理 」を参照してください。

UMDF バージョン 1 を使用してドライバーを作成する場合。x、 ドライバーは IWDFDeviceInitialize2::SetIoTypePreference を呼び出して、優先バッファー アクセス メソッドを指定します。

要件

要件 値
最小 KMDF バージョン 1.13
最小 UMDF バージョン 2.0
Header wdfdevice.h (Wdf.h を含む)

こちらもご覧ください

WDF_DEVICE_IO_TYPE

WDF_IO_TYPE_CONFIG_INIT

WdfDeviceInitSetIoTypeEx