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構造体の Characteristics メンバーを参照してください。

[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
Header wdfdevice.h (Wdf.h を含む)
Library Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 ChildDeviceInitAPI(kmdf)、 ControlDeviceInitAPI(kmdf)、 DeviceInitAPI(kmdf)、 DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf)、 PdoDeviceInitAPI(kmdf)

こちらもご覧ください

WdfDeviceSetCharacteristics