次の方法で共有


SpbControllerSetTargetAttributes 関数 (spbcx.h)

SpbControllerSetTargetAttributes メソッドは、SPB フレームワーク拡張機能 (SpbCx) が SPB コントローラー ドライバーに配信するすべての SPBTARGET オブジェクトに使用されるオブジェクト属性を設定します。

構文

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

パラメーター

[in] FxDevice

SPB コントローラーを表すデバイス オブジェクトへの WDFDEVICE ハンドル。

[in] ObjectAttributes

コントローラーの SPBTARGET オブジェクトの属性を含む呼び出し元によって割り当てられた WDF_OBJECT_ATTRIBUTES 構造体へのポインター。

戻り値

何一つ

備考

SPB コントローラー ドライバーは、このメソッドを呼び出して、SPBTARGET オブジェクトの既定の属性を設定します。 SPB フレームワーク拡張機能 (SpbCx) は、コントローラーのクライアント (周辺機器) によって開かれるバス上の任意のターゲット デバイスにこれらの属性を設定します。

ObjectAttributes は、WDF_OBJECT_ATTRIBUTES 構造体を指します。 この構造体を初期化するには、呼び出し元が以前に WDF_OBJECT_ATTRIBUTES_INIT 関数を呼び出している必要があります。 この呼び出しの後、spbControllerSetTargetAttributes 呼び出し前に、呼び出し元はこの構造体の次のメンバーの値を変更できます。

  • EvtCleanupCallback する
  • EvtDestroyCallback
  • ContextSizeOverride
  • ContextTypeInfo
spbControllerSetTargetAttributes は、これらの値を SPBTARGET オブジェクトの既定の属性として使用します。 ただし、ドライバーは、ExecutionLevelSynchronizationScope、および 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