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) entrega 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 de 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.

Retornar valor

Nenhum

Comentários

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 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 dessa 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, SynchronizationScope e 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 confirmar o objeto do dispositivo, ou seja, antes de retornar do retorno de chamada EvtDriverDeviceAdd 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
Cliente mínimo com suporte Disponível a partir do Windows 8.
Plataforma de Destino Universal
Cabeçalho spbcx.h
Biblioteca Spbcxstubs.lib
IRQL PASSIVE_LEVEL

Confira também

EvtDriverDeviceAdd

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT