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) |