Condividi tramite


Funzione SpbControllerSetTargetAttributes (spbcx.h)

Il metodo SpbControllerSetTargetAttributes imposta gli attributi dell'oggetto che verranno usati per tutti gli oggetti SPBTARGET che l'estensione del framework SPB (SpbCx) restituisce 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 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 del framework SPB (SpbCx) imposta questi attributi in tutti i dispositivi di destinazione sul 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 della struttura:

  • EvtCleanupCallback
  • EvtDestroyCallback
  • ContextSizeOverride
  • ContextTypeInfo
SpbControllerSetTargetAttributes userà questi valori come attributi predefiniti per gli oggetti SPBTARGET. Tuttavia, il driver non può modificare i valori predefiniti dell'attributo contenuti nei membri ExecutionLevel, SyncScope e ParentObject . Questi membri devono rimanere invariati dai valori inizializzati dalla funzione WDF_OBJECT_ATTRIBUTES_INIT .

Il driver del controller SPB deve chiamare questo metodo prima di eseguire il commit dell'oggetto dispositivo, ovvero prima che venga restituito dal callback EvtDriverDeviceAggiungi il callback o aggiunge l'oggetto PDO all'elenco figlio del controller. L'elenco figlio rappresenta i dispositivi collegati al bus. Per altre informazioni, vedere Enumerazione dei dispositivi in un bus.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 8.
Piattaforma di destinazione Universale
Intestazione spbcx.h
Libreria Spbcxstubs.lib
IRQL PASSIVE_LEVEL

Vedi anche

EvtDriverDeviceAdd

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT