次の方法で共有

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)