Функция SpbControllerSetTargetAttributes (spbcx.h)

Статья
08/07/2023

Метод SpbControllerSetTargetAttributes задает атрибуты объекта, которые будут использоваться для всех объектов SPBTARGET, которые расширение платформы SPB (SpbCx) доставляет драйверу контроллера SPB.

Синтаксис

void SpbControllerSetTargetAttributes(
  [in] WDFDEVICE              FxDevice,
  [in] PWDF_OBJECT_ATTRIBUTES ObjectAttributes
);

Параметры

[in] FxDevice

Дескриптор WDFDEVICE для объекта устройства, представляющего контроллер SPB.

[in] ObjectAttributes

Указатель на структуру WDF_OBJECT_ATTRIBUTES , выделенную вызывающим объектом, которая содержит атрибуты для объектов SPBTARGET контроллера.

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

None

Remarks

Драйвер контроллера SPB вызывает этот метод, чтобы задать атрибуты по умолчанию для объектов SPBTARGET. Расширение платформы SPB (SpbCx) задает эти атрибуты на всех целевых устройствах в шине, открытых клиентами (периферийными устройствами) контроллера.

ObjectAttributes указывает на WDF_OBJECT_ATTRIBUTES структуру. Вызывающий объект ранее должен вызывать функцию WDF_OBJECT_ATTRIBUTES_INIT для инициализации этой структуры. После этого вызова, но перед вызовом SpbControllerSetTargetAttributes, вызывающий объект может изменить значения следующих элементов этой структуры:

EvtCleanupCallback
EvtDeкистольcallback
ContextSizeOverride
ContextTypeInfo

SpbControllerSetTargetAttributes будет использовать эти значения в качестве атрибутов по умолчанию для объектов SPBTARGET. Однако драйвер не может изменить значения атрибутов по умолчанию, содержащиеся в элементах ExecutionLevel, SynchronizationScope и ParentObject . Эти элементы должны оставаться неизменными по сравнению со значениями, которыми они были инициализированы функцией WDF_OBJECT_ATTRIBUTES_INIT .

Драйвер контроллера SPB должен вызвать этот метод перед фиксацией объекта устройства, то есть перед тем, как он возвращается из обратного вызова EvtDriverDeviceAdd или добавляет PDO в дочерний список контроллера. Дочерний список представляет устройства, подключенные к шине. Дополнительные сведения см. в разделе Перечисление устройств в шине.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 8.
Целевая платформа	Универсальное
Верхняя часть	spbcx.h
Библиотека	Spbcxstubs.lib
IRQL	PASSIVE_LEVEL

См. также раздел

EvtDriverDeviceAdd

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT

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