WdfDeviceSetCharacteristics 関数 (wdfdevice.h)

[KMDF にのみ適用]

WdfDeviceSetCharacteristics メソッドは、指定されたデバイスのデバイス特性を設定します。

構文

void WdfDeviceSetCharacteristics(
  [in] WDFDEVICE Device,
  [in] ULONG     DeviceCharacteristics
);

パラメーター

[in] Device

フレームワーク デバイス オブジェクトへのハンドル。

[in] DeviceCharacteristics

デバイスの特性を表す ORed システム定義定数で構成される値。 詳細については、DEVICE_OBJECT 構造の 特性 メンバーを参照してください。

戻り値

何一つ

備考

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

WdfDeviceCreate を呼び出す前に、EvtDriverDeviceAdd コールバック関数で WdfDeviceInitSetCharacteristics メソッド呼び出すことによって、デバイスの特性を設定する必要があります。 EvtDriverDeviceAdd コールバック関数が戻るまで、ドライバーがデバイスの特性を判断できない場合、ドライバーは通常、EvtDevicePrepareHardware コールバック関数で WdfDeviceSetCharacteristics を呼び出す必要があります。

WdfDeviceSetCharacteristics の各呼び出しは、以前の呼び出しの設定を上書きします。

例

次のコード例では、指定したデバイスのFILE_REMOVABLE_MEDIA特性を設定します。

WdfDeviceSetCharacteristics(
                            Device,
                            FILE_REMOVABLE_MEDIA
                            );

必要条件

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

関連項目

WdfDeviceGetCharacteristics

WdfDeviceInitSetCharacteristics の