Compartir a través de

Función SpbControllerSetTargetAttributes (spbcx.h)

  • Artículo

El método SpbControllerSetTargetAttributes establece atributos de objeto que se usarán para todos los objetos SPBTARGET que la extensión del marco spB (SpbCx) entrega al controlador del controlador SPB.

Sintaxis

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

Parámetros

[in] FxDevice

Identificador WDFDEVICE para el objeto de dispositivo que representa el controlador SPB.

[in] ObjectAttributes

Puntero a una estructura de WDF_OBJECT_ATTRIBUTES asignada por el autor de la llamada que contiene atributos para los objetos SPBTARGET del controlador.

Valor devuelto

None

Observaciones

El controlador spb llama a este método para establecer los atributos predeterminados para los objetos SPBTARGET. La extensión de marco de SPB (SpbCx) establece estos atributos en cualquier dispositivo de destino del bus abierto por clientes (dispositivos periféricos) del controlador.

ObjectAttributes apunta a una estructura WDF_OBJECT_ATTRIBUTES . El autor de la llamada debe haber llamado previamente a la función WDF_OBJECT_ATTRIBUTES_INIT para inicializar esta estructura. Después de esta llamada, pero antes de la llamada a SpbControllerSetTargetAttributes, el llamador puede cambiar los valores de los siguientes miembros de esta estructura:

  • EvtCleanupCallback
  • EvtDestroyCallback
  • ContextSizeOverride
  • ContextTypeInfo
SpbControllerSetTargetAttributes usará estos valores como atributos predeterminados para objetos SPBTARGET. Sin embargo, el controlador no puede cambiar los valores de atributo predeterminados contenidos en los miembros ExecutionLevel, SynchronizationScope y ParentObject . Estos miembros deben permanecer inalterados de los valores a los que se inicializaron con la función WDF_OBJECT_ATTRIBUTES_INIT .

El controlador del controlador SPB debe llamar a este método antes de confirmar el objeto de dispositivo, es decir, antes de que vuelva de la devolución de llamada EvtDriverDeviceAdd o agregue el PDO a la lista secundaria del controlador. La lista secundaria representa los dispositivos conectados al bus. Para obtener más información, vea Enumerar los dispositivos en un bus.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows 8.
Plataforma de destino Universal
Encabezado spbcx.h
Library Spbcxstubs.lib
IRQL PASSIVE_LEVEL

Consulte también

EvtDriverDeviceAdd

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT