Функция WdfDeviceInitSetExclusive (wdfdevice.h)

Статья
02/29/2024

[Относится только к KMDF]

Метод WdfDeviceInitSetExclusive указывает, является ли указанное устройство монопольным.

Синтаксис

void WdfDeviceInitSetExclusive(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] BOOLEAN         IsExclusive
);

Параметры

[in] DeviceInit

Указатель на структуру WDFDEVICE_INIT .

[in] IsExclusive

Логическое значение, которое, если значение TRUE, указывает, что устройство является монопольным. Если значение РАВНО FALSE, устройство не является монопольным.

Возвращаемое значение

None

Remarks

Если драйвер вызывает WdfDeviceInitSetExclusive, он должен сделать это перед вызовом WdfDeviceCreate.

Если драйвер вызывает WdfDeviceInitSetExclusive, только объект устройства этого драйвера является монопольным. Чтобы сделать весь стек устройств монопольным, INF-файл устройства должен содержать директиву INF AddReg , которая устанавливает в реестре для записи Exclusiveзначение TRUE .

Дополнительные сведения о вызове 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

Поделиться через