Condividi tramite


Funzione SpbControllerSetTargetAttributes (spbcx.h)

Il metodo SpbControllerSetTargetAttributes imposta gli attributi dell'oggetto che verranno usati per tutti gli oggetti SPBTARGET recapitati dall'estensione spb framework (SpbCx) al driver del controller SPB.

Sintassi

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

Parametri

[in] FxDevice

Handle WDFDEVICE per l'oggetto dispositivo che rappresenta il controller SPB.

[in] ObjectAttributes

Puntatore a una struttura di WDF_OBJECT_ATTRIBUTES allocata dal chiamante che contiene attributi per gli oggetti SPBTARGET del controller.

Valore restituito

Nessuno

Osservazioni

Il driver del controller SPB chiama questo metodo per impostare gli attributi predefiniti per gli oggetti SPBTARGET. L'estensione spb framework (SpbCx) imposta questi attributi su tutti i dispositivi di destinazione nel bus aperti dai client (dispositivi periferici) del controller.

ObjectAttributes punta a una struttura WDF_OBJECT_ATTRIBUTES. Il chiamante deve in precedenza aver chiamato la funzione WDF_OBJECT_ATTRIBUTES_INIT per inizializzare questa struttura. Dopo questa chiamata, ma prima della chiamata a SpbControllerSetTargetAttributes, il chiamante può modificare i valori dei membri seguenti di questa struttura:

  • EvtCleanupCallback
  • EvtDestroyCallback
  • ContextSizeOverride
  • ContextTypeInfo
SpbControllerSetTargetAttributes useranno questi valori come attributi predefiniti per gli oggetti SPBTARGET. Tuttavia, il driver non può modificare i valori di attributo predefiniti contenuti nei membri ExecutionLevel, SynchronizationScopee ParentObject. Questi membri devono rimanere invariati rispetto ai valori inizializzati dalla funzione WDF_OBJECT_ATTRIBUTES_INIT.

Il driver del controller SPB deve chiamare questo metodo prima di esegue il commit'oggetto dispositivo, ovvero prima che venga restituito dalla EvtDriverDeviceAdd callback o aggiunge il PDO all'elenco figlio del controller. L'elenco figlio rappresenta i dispositivi collegati al bus. Per altre informazioni, vedere Enumerating the Devices on a Bus.

Fabbisogno

Requisito Valore
client minimo supportato Disponibile a partire da Windows 8.
piattaforma di destinazione Universale
intestazione spbcx.h
libreria Spbcxstubs.lib
IRQL PASSIVE_LEVEL

Vedere anche

EvtDriverDeviceAdd

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT