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 的详细信息,请参阅 创建框架设备对象

如果要编写 UMDF 驱动程序,则必须修改驱动程序的 INF 文件或进行注册表更改以指示设备是否为独占设备。 有关使用注册表的详细信息,请参阅 在安装期间设置设备对象注册表属性

示例

下面的代码示例指示设备是独占设备。

WdfDeviceInitSetExclusive(
                          DeviceInit,
                          TRUE
                          );

要求

要求
目标平台 通用
最低 KMDF 版本 1.0
标头 wdfdevice.h (包括 Wdf.h)
Library Wdf01000.sys (请参阅框架库版本控制.)
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 ChildDeviceInitAPI (kmdf) ControlDeviceInitAPI (kmdf) DeviceInitAPI (kmdf) DriverCreate (kmdf) KmdfIrql (kmdf) KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf) , PdoDeviceInitAPI (kmdf)

另请参阅

EvtDriverDeviceAdd

WdfDeviceCreate