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

Статья
02/07/2025

[Применимо только к KMDF]

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

Синтаксис

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

Параметры

[in] DeviceInit

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

[in] IsExclusive

Логическое значение, которое, если TRUE, указывает, что устройство является эксклюзивным устройством. Если FALSE, устройство не является эксклюзивным.

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

Никакой

Замечания

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

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

Дополнительные сведения о вызове WdfDeviceCreateсм. в создании объекта устройства Framework.

Если вы пишете драйвер UMDF, необходимо изменить INF-файл драйвера или внести изменения в реестр, чтобы указать, является ли устройство эксклюзивным. Дополнительные сведения об использовании реестра см. в разделе Настройка свойств реестра объектов устройства во время установки.

Примеры

В следующем примере кода указывается, что устройство является эксклюзивным устройством.

WdfDeviceInitSetExclusive(
                          DeviceInit,
                          TRUE
                          );

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.0
заголовка	wdfdevice.h (include 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

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