다음을 통해 공유

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)은 컨트롤러의 클라이언트(주변 장치)에서 열리는 버스의 모든 대상 디바이스에서 이러한 특성을 설정합니다.

ObjectAttributesWDF_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