WDF_DEVICE_IO_TYPE列挙 (wudfddi_types.h)

  • [アーティクル]

[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、新しいバージョンのWindows 10では UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは、UMDF 2 を使用する必要があります。 詳細については、「UMDF を使用したはじめに」を参照してください。

WDF_DEVICE_IO_TYPE列挙は、データ バッファーにアクセスするためのメソッドを指定するために使用されます。

構文

typedef enum _WDF_DEVICE_IO_TYPE {
  WdfDeviceIoUndefined,
  WdfDeviceIoNeither,
  WdfDeviceIoBuffered,
  WdfDeviceIoDirect,
  WdfDeviceIoBufferedOrDirect,
  WdfDeviceIoMaximum
} WDF_DEVICE_IO_TYPE, *PWDF_DEVICE_IO_TYPE;

定数

 
WdfDeviceIoUndefined
システムで使用するために予約されています。
WdfDeviceIoNeither
システムで使用するために予約されています。
WdfDeviceIoBuffered
UMDF とドライバーは、 バッファーされた I/O を使用してデータ バッファーにアクセスします。
WdfDeviceIoDirect
UMDF とドライバーは、 ダイレクト I/O を使用してデータ バッファーにアクセスします。
WdfDeviceIoBufferedOrDirect
UMDF とドライバーは、バッファーされた I/O またはダイレクト I/O を使用してデータ バッファーにアクセスできます。
WdfDeviceIoMaximum
システムで使用するために予約されています。

注釈

WDF_DEVICE_IO_TYPE列挙は、IWDFDeviceInitialize2::SetIoTypePreference への入力として使用され、IWDFIoRequest2::GetEffectiveIoType からの出力として使用されます。

ドライバーの I/O の種類を選択するときは、次のガイドラインを使用する必要があります。

  • バッファー I/O は、アプリケーションとドライバーがデータの個別のコピーにアクセスするため、最高のセキュリティと信頼性を提供します。 さらに、ほとんどのデータ転送が比較的小さい (通常は 2 つのメモリ ページ以下) 場合、バッファー I/O は最適なパフォーマンスを提供します。
  • ダイレクト I/O は、ほとんどの I/O 要求で大量のデータが転送される場合に最適なパフォーマンスを提供します。 ただし、アプリケーションとドライバーは、データの単一のコピーにアクセスします。 そのため、ドライバーは、検証後にアプリケーションがパラメーターを変更しないように、パラメーターを検証する前に、アプリケーション指定のパラメーターをローカル ドライバー メモリにコピーする必要があります。 ドライバーが大量のアプリケーション データを検証する必要がある場合は、ドライバーが検証する前にデータをコピーする必要がないため、バッファー I/O が適している可能性があります。
  • 通常、複数のドライバー スタックに存在し、アプリケーション データの処理をほとんど実行できないフィルター ドライバーは、バッファー処理された I/O とダイレクト I/O の両方をサポートできるため、 WdfDeviceIoBufferedOrDirect を指定できます。 ただし、ドライバーがアプリケーション指定のパラメーターを検証する場合は、ダイレクト I/O を使用するときに最初にコピーする必要があります。
I/O 要求のデータ バッファーへのアクセスの詳細については、「 UMDF-Based ドライバーでのデータ バッファーへのアクセス」を参照してください。

この列挙体の KMDF バージョンについては、「 WDF_DEVICE_IO_TYPE」を参照してください。

要件

要件 値
最小 UMDF バージョン 1.9
Header wudfddi_types.h (Wudfddi.h を含む)

こちらもご覧ください

IWDFDeviceInitialize2::SetIoTypePreference

IWDFIoRequest2::GetEffectiveIoType

WDF_DEVICE_IO_BUFFER_RETRIEVAL