次の方法で共有

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 呼び出す方法の詳細については、「フレームワーク デバイス オブジェクトの作成」を参照してください。

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

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

例

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

WdfDeviceInitSetDeviceType(
                           DeviceInit,
                           FILE_DEVICE_SERIAL_PORT
                           );

必要条件

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