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)

另請參閱

EvtDriverDeviceAdd

WdfDeviceCreate