次の方法で共有

WdfDeviceInitSetIoType 関数 (wdfdevice.h)

  • [アーティクル]

[KMDF と UMDF に適用]

WdfDeviceInitSetIoType メソッドは、ドライバーが指定したデバイスの読み取りおよび書き込み要求に含まれるデータ バッファーにアクセスする方法のメソッドまたは基本設定を設定します。

構文

void WdfDeviceInitSetIoType(
  [in] PWDFDEVICE_INIT    DeviceInit,
  [in] WDF_DEVICE_IO_TYPE IoType
);

パラメーター

[in] DeviceInit

WDFDEVICE_INIT 構造体へのポインター。

[in] IoType

ドライバーが読み取りおよび書き込み要求に対して受信するデータ バッファーにアクセスするために使用するメソッドを識別する、WDF_DEVICE_IO_TYPE型指定された列挙子。

戻り値

何一つ

備考

KMDF KMDF バージョン 1.13 以降を使用して新しいドライバーを作成する場合は、代わりに WdfDeviceInitSetIoTypeExを使用する必要があります。 KMDF フィルター ドライバーから WdfDeviceInitSetIoType 呼び出しても効果はありません。 フィルター ドライバーの場合、フレームワークは、ドライバー スタック内の次の下位ドライバーで指定された I/O の種類を使用します。

UMDF WdfDeviceInitSetIoType を呼び出す KMDF ドライバーを UMDF バージョン 2.0 以降に変換する場合、変換されたドライバーは、WdfDeviceInitSetIoType を問題なく引き続き呼び出すことができます。 ただし、UMDF バージョン 2.0 以降を使用してまったく新しいドライバーを作成する場合は、代わりに WdfDeviceInitSetIoTypeExを使用する必要があります。

ドライバーが WdfDeviceInitSetIoType 呼び出す場合は、WdfDeviceCreateを呼び出す前に呼び出す必要があります。 WdfDeviceCreate 呼び出す方法の詳細については、「フレームワーク デバイス オブジェクトの作成」を参照してください。

ドライバーが WdfDeviceInitSetIoType 呼び出さない場合、フレームワークは、指定したデバイスの WdfDeviceIoBuffered をするドライバーのバッファー アクセス メソッドを設定します。

バッファー アクセス方法の詳細については、「データ バッファーへのアクセス」を参照してください。

例

次のコード例は、ドライバーがデバイスにアクセスするときにダイレクト I/O メソッドを使用することを示します。

WdfDeviceInitSetIoType(
                       DeviceInit,
                       WdfDeviceIoDirect
                       );

必要条件

要件 価値
ターゲット プラットフォーム の 万国
最小 KMDF バージョン 1.0
UMDF の最小バージョン を する 2.0
ヘッダー wdfdevice.h (Wdf.h を含む)
ライブラリ Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 を する ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

関連項目

IWDFDeviceInitialize2::SetIoTypePreference

WDF_DEVICE_IO_TYPE

WdfDeviceInitSetIoTypeEx の