WdfDeviceInitSetExclusive 関数 (wdfdevice.h)
[KMDF にのみ適用]
WdfDeviceInitSetExclusive メソッドは、指定したデバイスが排他デバイスであるかどうかを示します。
構文
void WdfDeviceInitSetExclusive(
[in] PWDFDEVICE_INIT DeviceInit,
[in] BOOLEAN IsExclusive
);
パラメーター
[in] DeviceInit
WDFDEVICE_INIT構造体へのポインター。
[in] IsExclusive
ブール値。 TRUE の場合は、デバイスが排他的なデバイスであることを示します。 FALSE の場合、デバイスは排他的なデバイスではありません。
戻り値
なし
解説
ドライバーが WdfDeviceInitSetExclusive を呼び出す場合は、 WdfDeviceCreate を呼び出す前に呼び出す必要があります。
ドライバーが WdfDeviceInitSetExclusive を呼び出す場合、そのドライバーのデバイス オブジェクトのみが排他的です。 デバイスのデバイス スタック全体を排他的にするには、デバイスの INF ファイルに、レジストリで Exclusive エントリを TRUE に設定する INF AddReg ディレクティブを含める必要があります。
WdfDeviceCreate の呼び出しの詳細については、「フレームワーク デバイス オブジェクトの作成」を参照してください。
UMDF ドライバーを作成する場合は、ドライバーの INF ファイルを変更するか、レジストリを変更して、デバイスが排他的であるかどうかを示す必要があります。 レジストリの使用の詳細については、「 インストール時のデバイス オブジェクト レジストリプロパティの設定」を参照してください。
例
次のコード例は、デバイスが排他的なデバイスであることを示しています。
WdfDeviceInitSetExclusive(
DeviceInit,
TRUE
);
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 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) |