Share via

SpbControllerSetTargetAttributes, fonction (spbcx.h)

  • Article

La méthode SpbControllerSetTargetAttributes définit les 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

Un handle WDFDEVICE pour l’objet d’appareil qui représente le contrôleur SPB.

[in] ObjectAttributes

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

Valeur de retour

None

Remarques

Votre pilote de contrôleur SPB appelle cette méthode pour définir les attributs par défaut des objets SPBTARGET. L’extension SPB framework (SpbCx) définit ces attributs sur tous les appareils cibles du bus 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 les membres ExecutionLevel, SynchronizationScope et ParentObject . Ces membres doivent rester inchangés par rapport aux valeurs pour lesquelles ils ont été initialisés par la fonction WDF_OBJECT_ATTRIBUTES_INIT .

Le pilote du contrôleur SPB doit appeler cette méthode avant de valider l’objet d’appareil, c’est-à-dire avant qu’il ne retourne à partir du rappel EvtDriverDeviceAdd ou qu’il n’ajoute le PDO à la liste enfant du contrôleur. La liste enfant représente les appareils qui sont attachés au bus. Pour plus d’informations, consultez Énumération des appareils sur un bus.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 8.
Plateforme cible Universal
En-tête spbcx.h
Bibliothèque Spbcxstubs.lib
IRQL PASSIVE_LEVEL

Voir aussi

EvtDriverDeviceAdd

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT