WdfDeviceInitSetDeviceType 関数 (wdfdevice.h)

[KMDF にのみ適用]

WdfDeviceInitSetDeviceType メソッドは、指定したデバイスのデバイスの種類を設定します。

構文

void WdfDeviceInitSetDeviceType(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] DEVICE_TYPE     DeviceType
);

[in] DeviceInit

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

[in] DeviceType

デバイスの種類を識別するFILE_DEVICE_XXXX値。 FILE_DEVICE_XXXX値の詳細については、「デバイスの種類の指定」を参照してください。

なし

ドライバーが WdfDeviceInitSetDeviceType を呼び出す場合は、 WdfDeviceCreate を呼び出す前に呼び出す必要があります。

WdfDeviceCreate の呼び出しの詳細については、「Framework デバイスオブジェクトの作成」を参照してください。

ドライバーが指定するデバイスの種類によって、ドライバーが I/O 要求を完了するときにフレームワークが使用する既定の優先度ブースト値が決まります。優先度ブースト値の詳細については、「 I/O 要求の完了時の優先度ブーストの指定」を参照してください。

UMDF ドライバーを作成する場合は、ドライバーの INF ファイルを変更するか、レジストリを変更してデバイスの種類を指定する必要があります。レジストリの使用方法の詳細については、「インストール時のデバイスオブジェクトレジストリプロパティの設定」を参照してください。

次のコード例は、デバイスがシリアルデバイスであることを示しています。

WdfDeviceInitSetDeviceType(
                           DeviceInit,
                           FILE_DEVICE_SERIAL_PORT
                           );

要件	値
対象プラットフォーム	ユニバーサル
最小 KMDF バージョン	1.0
Header	wdfdevice.h (Wdf.h を含む)
Library	Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則	ChildDeviceInitAPI(kmdf)、 DeviceInitAPI(kmdf)、 DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf)、 PdoDeviceInitAPI(kmdf)