Compartir a través de


Función SpbControllerSetTargetAttributes (spbcx.h)

El método SpbControllerSetTargetAttributes establece atributos de objeto que se usarán para todos los objetos SPBTARGET que la extensión del marco de 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

Ninguno

Observaciones

El controlador del 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 los dispositivos de destino del bus abiertos por clientes (dispositivos periféricos) del controlador.

ObjectAttributes apunta a una estructura de 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 autor de la llamada puede cambiar los valores de los siguientes miembros de esta estructura:

  • EvtCleanupCallback
  • EvtDestroyCallback
  • ContextSizeOverride de
  • ContextTypeInfo de
spbControllerSetTargetAttributes usará estos valores como atributos predeterminados para los objetos SPBTARGET. Sin embargo, el controlador no puede cambiar los valores de atributo predeterminados incluidos en los miembros ExecutionLevel, SynchronizationScopey ParentObject. Estos miembros deben permanecer sin cambios de los valores a los que se inicializaron en la función WDF_OBJECT_ATTRIBUTES_INIT.

El controlador del controlador SPB debe llamar a este método antes de confirma el objeto de dispositivo, es decir, antes de que vuelva de la EvtDriverDeviceAdd devolución de llamada 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 Valor
cliente mínimo admitido Disponible a partir de Windows 8.
de la plataforma de destino de Universal
encabezado de spbcx.h
biblioteca de Spbcxstubs.lib
irQL PASSIVE_LEVEL

Consulte también

EvtDriverDeviceAdd

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT