Partager via

SpbControllerSetTargetAttributes, fonction (spbcx.h)

  • Article

Le SpbControllerSetTargetAttributes méthode définit des attributs d’objet qui seront utilisés pour tous les objets SPBTARGET que l’extension de framework SPB (SpbCx) remet au pilote du contrôleur SPB.

Syntaxe

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

Paramètres

[in] FxDevice

Handle WDFDEVICE sur l’objet d’appareil qui représente le contrôleur SPB.

[in] ObjectAttributes

Pointeur vers une structure WDF_OBJECT_ATTRIBUTES allouée par l’appelant qui contient des attributs pour les objets SPBTARGET du contrôleur.

Valeur de retour

Aucun

Remarques

Votre pilote de contrôleur SPB appelle cette méthode pour définir les attributs par défaut pour les objets SPBTARGET. L’extension de framework SPB (SpbCx) définit ces attributs sur tous les appareils cibles sur le bus qui sont ouverts par les clients (périphériques) du contrôleur.

ObjectAttributes pointe vers une structure WDF_OBJECT_ATTRIBUTES. L’appelant doit avoir précédemment appelé la fonction WDF_OBJECT_ATTRIBUTES_INIT pour initialiser cette structure. Après cet appel, mais avant l’appel à SpbControllerSetTargetAttributes, l’appelant peut modifier les valeurs des membres suivants de cette structure :

  • EvtCleanupCallback
  • EvtDestroyCallback
  • ContextSizeOverride
  • ContextTypeInfo
SpbControllerSetTargetAttributes utilise ces valeurs comme attributs par défaut pour les objets SPBTARGET. Toutefois, le pilote ne peut pas modifier les valeurs d’attribut par défaut contenues dans le ExecutionLevel, SynchronizationScopeet membres parentObject. Ces membres doivent rester inchangés par rapport aux valeurs auxquelles ils ont été initialisés par la fonction WDF_OBJECT_ATTRIBUTES_INIT.

Le pilote du contrôleur SPB doit appeler cette méthode avant qu’elle n'valide l’objet d’appareil, autrement dit, avant de retourner à partir de la EvtDriverDeviceAdd rappel ou ajoute l’objet PDO à la liste enfant du contrôleur. La liste enfant représente les appareils attachés au bus. Pour plus d’informations, consultez énumération des appareils sur un bus.

Exigences

Exigence Valeur
client minimum pris en charge Disponible à partir de Windows 8.
plateforme cible Universel
d’en-tête spbcx.h
bibliothèque Spbcxstubs.lib
IRQL PASSIVE_LEVEL

Voir aussi

EvtDriverDeviceAdd

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT