Compartilhar via

Função SpbControllerSetTargetAttributes (spbcx.h)

  • Artigo

O método SpbControllerSetTargetAttributes define atributos de objeto que serão usados para todos os objetos SPBTARGET que a extensão da estrutura SPB (SpbCx) fornece ao driver do controlador SPB.

Sintaxe

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

Parâmetros

[in] FxDevice

Um identificador WDFDEVICE para o objeto do dispositivo que representa o controlador SPB.

[in] ObjectAttributes

Um ponteiro para uma estrutura de WDF_OBJECT_ATTRIBUTES alocada pelo chamador que contém atributos para os objetos SPBTARGET do controlador.

Valor de retorno

Nenhum

Observações

O driver do controlador SPB chama esse método para definir os atributos padrão para objetos SPBTARGET. A extensão da estrutura SPB (SpbCx) define esses atributos em qualquer dispositivo de destino no barramento aberto por clientes (dispositivos periféricos) do controlador.

ObjectAttributes aponta para uma estrutura de WDF_OBJECT_ATTRIBUTES. O chamador deve ter chamado anteriormente a função WDF_OBJECT_ATTRIBUTES_INIT para inicializar essa estrutura. Após essa chamada, mas antes da chamada para SpbControllerSetTargetAttributes, o chamador pode alterar os valores dos seguintes membros desta estrutura:

  • EvtCleanupCallback
  • EvtDestroyCallback
  • ContextSizeOverride
  • ContextTypeInfo
SpbControllerSetTargetAttributes usará esses valores como atributos padrão para objetos SPBTARGET. No entanto, o driver não pode alterar os valores de atributo padrão contidos nos membros ExecutionLevel, SynchronizationScopee ParentObject. Esses membros devem permanecer inalterados dos valores aos quais foram inicializados pela função WDF_OBJECT_ATTRIBUTES_INIT.

O driver do controlador SPB deve chamar esse método antes de confirma objeto do dispositivo, ou seja, antes de retornar do EvtDriverDeviceAdd retorno de chamada ou adicionar o PDO à lista filho do controlador. A lista filho representa os dispositivos anexados ao barramento. Para obter mais informações, consulte Enumerando os dispositivos em um barramento.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível a partir do Windows 8.
da Plataforma de Destino Universal
cabeçalho spbcx.h
biblioteca Spbcxstubs.lib
IRQL PASSIVE_LEVEL

Consulte também

EvtDriverDeviceAdd

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT