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