SpbControllerSetTargetAttributes-Funktion (spbcx.h)

Artikel
02/29/2024

Die SpbControllerSetTargetAttributes-Methode legt Objektattribute fest, die für alle SPBTARGET-Objekte verwendet werden, die von der SPB-Frameworkerweiterung (SpbCx) an den SPB-Controllertreiber übermittelt werden.

Syntax

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

Parameter

[in] FxDevice

Ein WDFDEVICE-Handle für das Geräteobjekt, das den SPB-Controller darstellt.

[in] ObjectAttributes

Ein Zeiger auf eine vom Aufrufer zugeordnete WDF_OBJECT_ATTRIBUTES-Struktur , die Attribute für die SPBTARGET-Objekte des Controllers enthält.

Rückgabewert

Keine

Bemerkungen

Ihr SPB-Controllertreiber ruft diese Methode auf, um die Standardattribute für SPBTARGET-Objekte festzulegen. Die SPB-Frameworkerweiterung (SpbCx) legt diese Attribute auf allen Zielgeräten im Bus fest, die von Clients (Peripheriegeräten) des Controllers geöffnet werden.

ObjectAttributes verweist auf eine WDF_OBJECT_ATTRIBUTES-Struktur . Der Aufrufer muss zuvor die funktion WDF_OBJECT_ATTRIBUTES_INIT aufgerufen haben, um diese Struktur zu initialisieren. Nach diesem Aufruf, aber vor dem Aufruf von SpbControllerSetTargetAttributes, kann der Aufrufer die Werte der folgenden Member dieser Struktur ändern:

EvtCleanupCallback
EvtDestroyCallback
ContextSizeOverride
ContextTypeInfo

SpbControllerSetTargetAttributes verwendet diese Werte als Standardattribute für SPBTARGET-Objekte. Der Treiber kann jedoch die Standardattributewerte, die in den Membern ExecutionLevel, SynchronizationScope und ParentObject enthalten sind, nicht ändern. Diese Member müssen gegenüber den Werten, mit denen sie von der WDF_OBJECT_ATTRIBUTES_INIT-Funktion initialisiert wurden, unverändert bleiben.

Der SPB-Controllertreiber muss diese Methode aufrufen, bevor er einen Commit für das Geräteobjekt durchführt, d. h. bevor er aus dem EvtDriverDeviceAdd-Rückruf zurückgibt oder den PDO der untergeordneten Liste des Controllers hinzufügt. Die untergeordnete Liste stellt die Geräte dar, die an den Bus angefügt sind. Weitere Informationen finden Sie unter Auflisten der Geräte in einem Bus.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.
Zielplattform	Universell
Header	spbcx.h
Bibliothek	Spbcxstubs.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

EvtDriverDeviceAdd

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT

Freigeben über