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 ファイルに、レジストリの TRUE を に 排他 エントリを設定する INF AddReg ディレクティブ を含める必要があります。

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

UMDF ドライバーを作成する場合は、ドライバーの INF ファイルを変更するか、デバイスが排他的かどうかを示すレジストリの変更を行う必要があります。 レジストリの使用の詳細については、「インストール時のデバイス オブジェクト レジストリプロパティの設定 を参照してください。

例

次のコード例は、デバイスが排他的デバイスであることを示しています。

WdfDeviceInitSetExclusive(
                          DeviceInit,
                          TRUE
                          );

必要条件

要件	価値
ターゲット プラットフォーム の	万国
最小 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)

関連項目

EvtDriverDeviceAdd の

WdfDeviceCreate