共用方式為

SpbControllerSetTargetAttributes 函式 （spbcx.h）

  • 發行項

SpbControllerSetTargetAttributes 方法會設定物件屬性，這些屬性將用於 SPB 架構延伸模組 （SpbCx） 傳遞給 SPB 控制器驅動程式的所有 SPBTARGET 物件。

語法

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

參數

[in] FxDevice

代表SPB控制器之裝置物件的WDFDEVICE句柄。

[in] ObjectAttributes

呼叫端配置的 WDF_OBJECT_ATTRIBUTES 結構的指標，其中包含控制器 SPBTARGET 對象的屬性。

傳回值

沒有

言論

SPB 控制器驅動程式會呼叫這個方法，以設定 SPBTARGET 對象的預設屬性。 SPB 架構延伸模組 （SpbCx） 會將這些屬性設定在控制器客戶端（周邊裝置）所開啟之總線上的任何目標裝置上。

ObjectAttributes 指向 WDF_OBJECT_ATTRIBUTES 結構。 呼叫端先前必須呼叫 WDF_OBJECT_ATTRIBUTES_INIT 函式，才能初始化這個結構。 在此呼叫之後，但在呼叫 SpbControllerSetTargetAttributes之前，呼叫者可以變更這個結構中下列成員的值：

  • EvtCleanupCallback
  • EvtDestroyCallback
  • ContextSizeOverride
  • ContextTypeInfo
SpbControllerSetTargetAttributes 會使用這些值作為 SPBTARGET 對象的預設屬性。 不過，驅動程式無法變更包含在 ExecutionLevel、SynchronizationScope和 ParentObject 成員中的預設屬性值。 這些成員必須與 WDF_OBJECT_ATTRIBUTES_INIT 函式初始化的值保持不變。

SPB 控制器驅動程序必須先呼叫此方法，認可裝置物件，也就是說，在從 EvtDriverDeviceAdd 傳回之前， 回呼或將 PDO 新增至控制器的子清單。 子清單代表連接至總線的裝置。 如需詳細資訊，請參閱 列舉總線上的裝置。

要求

要求 價值
最低支援的用戶端 從 Windows 8 開始提供。
目標平臺 普遍
標頭 spbcx.h
連結庫 Spbcxstubs.lib
IRQL PASSIVE_LEVEL

另請參閱

EvtDriverDeviceAdd

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT