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 檔案應該包含 INF AddReg 指示詞 ，將 登錄中的獨佔 專案設定為 TRUE 。
如需呼叫 WdfDeviceCreate 的詳細資訊，請參閱 建立 Framework 裝置物件。
如果您要撰寫 UMDF 驅動程式，您必須修改驅動程式的 INF 檔案，或進行登錄變更，以指出裝置是否為獨佔。 如需使用登錄的詳細資訊，請參閱 在安裝期間設定裝置物件登錄屬性。
範例
下列程式代碼範例指出裝置是獨佔裝置。
WdfDeviceInitSetExclusive(
DeviceInit,
TRUE
);
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最小 KMDF 版本 | 1.0 |
| 標頭 | wdfdevice.h (包含 Wdf.h) |
| 程式庫 | Wdf01000.sys (請參閱 Framework Library Versioning.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI 合規性規則 | ChildDeviceInitAPI (kmdf) 、 ControlDeviceInitAPI (kmdf) 、 DeviceInitAPI (kmdf) 、 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf ) 、KmdfIrqlExplicit (kmdf) 、 PdoDeviceInitAPI (kmdf) |