Freigeben über

SpbControllerSetTargetAttributes-Funktion (spbcx.h)

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 zugewiesene WDF_OBJECT_ATTRIBUTES Struktur, die Attribute für die SPBTARGET-Objekte des Controllers enthält.

Rückgabewert

Nichts

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 auf dem Bus fest, der von Clients (Peripheriegeräten) des Controllers geöffnet wird.

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

  • EvtCleanupCallback
  • EvtDestroyCallback-
  • ContextSizeOverride-
  • ContextTypeInfo-
SpbControllerSetTargetAttributes diese Werte als Standardattribute für SPBTARGET-Objekte verwenden. Der Treiber kann jedoch nicht die Standardattributewerte ändern, die in den Membern ExecutionLevel, SynchronizationScopeund ParentObject Member enthalten sind. Diese Member müssen von den Werten unverändert bleiben, auf die sie von der WDF_OBJECT_ATTRIBUTES_INIT-Funktion initialisiert wurden.

Der SPB-Controllertreiber muss diese Methode aufrufen, bevor er commits das Geräteobjekt, d. h. bevor er aus der EvtDriverDeviceAdd Rückruf zurückgibt oder der untergeordneten Liste des Controllers die PDO hinzufügt. Die untergeordnete Liste stellt die Geräte dar, die an den Bus angeschlossen sind. Weitere Informationen finden Sie unter Aufzählen der Geräte auf einem Bus-.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Verfügbar ab Windows 8.
Zielplattform- Universal
Header- spbcx.h
Library Spbcxstubs.lib
IRQL- PASSIVE_LEVEL

Siehe auch

EvtDriverDeviceAdd

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT

  • Last updated on