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

Метод 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 контроллера.

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

Никакой

Замечания

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

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

  • EvtCleanupCallback
  • EvtDeskallback
  • 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

  • Last updated on