IddCxSwapChainReleaseAndAcquireBuffer2 함수(iddcx.h)

아티클
02/26/2024

간접 디스플레이 드라이버는 IddCxSwapChainReleaseAndAcquireBuffer2 를 호출하여 스왑 체인의 현재 버퍼를 해제하고 새 버퍼를 획득합니다. HDR 어댑터를 지원하는 드라이버는 IddCxSwapChainReleaseAndAcquireBuffer 및 IddCxSwapChainReleaseAndAcquireBuffer 및 IddCxSwapChainReleaseAndAcquireSystemBuffer 대신 IddCxSwapChainReleaseAndAcquireBuffer를 사용해야 합니다.

구문

HRESULT IddCxSwapChainReleaseAndAcquireBuffer2(
  IDDCX_SWAPCHAIN                    SwapChainObject,
  IDARG_IN_RELEASEANDACQUIREBUFFER2  *pInArgs,
  IDARG_OUT_RELEASEANDACQUIREBUFFER2 *pOutArgs
);

매개 변수

SwapChainObject

[in] 이전에 OS가 EVT_IDD_CX_MONITOR_ASSIGN_SWAPCHAIN 호출에서 드라이버에 전달한 스왑 체인 개체입니다.

pInArgs

[in] 함수에 대한 입력 인수를 포함하는 IDARG_IN_RELEASEANDACQUIREBUFFER2 구조체에 대한 포인터입니다.

pOutArgs

[out] 함수의 출력 인수가 반환되는 IDARG_OUT_RELEASEANDACQUIREBUFFER2 구조체에 대한 포인터입니다.

반환 값

IddCxSwapChainReleaseAndAcquireBuffer2 는 성공 시 S_OK 반환합니다. 그렇지 않으면 적절한 오류 코드를 반환합니다.

설명

IDDCX_METADATA2 구조체에 전달된 표면의 색 공간도 드라이버에 전달됩니다. 이는 모드가 커밋될 때 지정된 색 공간과 일치하지 않고 프레임별로 변경될 수 있기 때문입니다.

마찬가지로 제공된 표면의 픽셀 형식은 프레임 단위로 변경될 수 있습니다. 예를 들어 HDR 모드가 경로에서 커밋되는 경우 모든 표면이 FP16 표면이 되도록 보장하지는 않습니다.

SDR 콘텐츠의 흰색 수준도 마우스 커서에 적용되도록 포함됩니다.

IDDCX_METADATA2::ValidFlags에서 IDDCX_METADATA2_VALID_FLAGS_HDR10METADATA 설정된 경우 IDDCX_METADATA2::Hdr10FrameMetaData에 유효한 데이터가 포함됩니다. 이 메타데이터는 다음 세 가지 유형 중 하나일 수 있습니다.

드라이버에서 사용해야 하는 새 데이터입니다.
EVT_IDD_CX_MONITOR_SET_DEFAULT_HDR_METADATA 호출에서 드라이버에 이전에 전송된 기본 메타데이터를 사용해야 한다는 표시입니다.
이전에 전송된 메타데이터를 다시 사용해야 한다는 표시입니다. 형식이 기본값이거나 변경되지 않은 경우 IDDCX_HDR10_FRAME_METADATA::NewMetaData 의 값이 잘못되었습니다.

IddCxSwapChainReleaseAndAcquireBuffer2 도 IddCxSwapChainReleaseAndAcquireSystemBuffer를 대체합니다. IddCxSwapChainReleaseAndAcquireSystemBuffer를 호출한 드라이버는 IDARG_IN_RELEASEANDACQUIREBUFFER2::AcquireSystemMemoryBuffer를 설정하여 IDDCX_METADATA2::SystemBufferInfo가 채워져야 함을 나타낼 수 있습니다.

FP16 지원을 보고하지 않는 버전 1.10 드라이버는 OS에서 사용할 수 있는 경우에도 이 함수를 호출할 수 있습니다.

HDR 지원에 대한 자세한 내용은 IddCx 버전 1.10 업데이트를 참조하세요.

원격 HDR 메타데이터

클라이언트 시스템에서 HDR 메타데이터를 사용해야 하며 서버에서 생성된 것이 아니므로 OS는 원격 드라이버에 HDR 메타데이터를 전달하지 않습니다. 원격 드라이버 의 경우 IDDCX_METADATA2_VALID_FLAGS_HDR10METADATA 설정되지 않습니다.