SpbControllerSetTargetAttributes, fonction (spbcx.h)
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
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 |