WdfDeviceInitSetCharacteristics 関数 (wdfdevice.h)

[KMDF にのみ適用]

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

構文

void WdfDeviceInitSetCharacteristics(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] ULONG           DeviceCharacteristics,
  [in] BOOLEAN         OrInValues
);

パラメーター

[in] DeviceInit

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

[in] DeviceCharacteristics

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

[in] OrInValues

ブール値。 この値が TRUE 場合、DeviceCharacteristics 値は既存のデバイス特性を持つ ORed になります。 値が FALSE 場合、DeviceCharacteristics 値は既存のデバイス特性に置き換えられます。

戻り値

何一つ

備考

デバイスの特性を設定するには、WdfDeviceCreate を呼び出す前に、EvtDriverDeviceAdd コールバック関数で WdfDeviceInitSetCharacteristics メソッド呼び出します。 EvtDriverDeviceAdd コールバック関数が戻るまでドライバーがデバイスの特性を判断できない場合は、WdfDeviceSetCharacteristicsを呼び出します。

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

フレームワークは常にFILE_DEVICE_SECURE_OPEN特性を設定するため、ドライバーはこの特性を設定する必要はありません。

WdfDeviceInitSetCharacteristics 各呼び出し 前の呼び出しの設定が上書きされます。

例

次のコード例は、デバイスがフロッピー ディスクであることを示しています。

WdfDeviceInitSetCharacteristics(
                                DeviceInit,
                                FILE_FLOPPY_DISKETTE,
                                FALSE
                                );

必要条件

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

関連項目

WdfDeviceSetCharacteristics の