IDXGIFactoryMedia::CreateSwapChainForCompositionSurfaceHandle 메서드(dxgi1_3.h)

기존 DirectComposition 표면 핸들에 대한 YUV 스왑 체인을 만듭니다.

구문

HRESULT CreateSwapChainForCompositionSurfaceHandle(
  [in]           IUnknown                    *pDevice,
  [in, optional] HANDLE                      hSurface,
  [in]           const DXGI_SWAP_CHAIN_DESC1 *pDesc,
  [in, optional] IDXGIOutput                 *pRestrictToOutput,
  [out]          IDXGISwapChain1             **ppSwapChain
);

매개 변수

[in] pDevice

스왑 체인의 Direct3D 디바이스에 대한 포인터입니다. 이 매개 변수는 NULL일 수 없습니다. D3D_DRIVER_TYPE_REFERENCE 같은 소프트웨어 드라이버는 컴퍼지션 스왑 체인에 대해 지원되지 않습니다.

[in, optional] hSurface

기존 DirectComposition 표면에 대한 핸들입니다. 이 매개 변수는 NULL일 수 없습니다.

[in] pDesc

스왑 체인 설명에 대한 DXGI_SWAP_CHAIN_DESC1 구조체에 대한 포인터입니다. 이 매개 변수는 NULL일 수 없습니다.

[in, optional] pRestrictToOutput

콘텐츠를 제한할 스왑 체인의 IDXGIOutput 인터페이스에 대한 포인터입니다. 스왑 체인이 다른 출력으로 이동되면 콘텐츠가 검은색으로 표시됩니다. 필요에 따라 이 매개 변수를 DXGI_PRESENT_RESTRICT_TO_OUTPUT 사용하여 이 출력의 콘텐츠를 제한하는 출력 대상으로 설정할 수 있습니다. 스왑 체인이 다른 출력으로 이동되면 콘텐츠가 검은색으로 표시됩니다.

또한 현재 호출에서 DXGI_PRESENT_RESTRICT_TO_OUTPUT 플래그를 전달하여 콘텐츠가 다른 출력에서 검은색으로 표시되도록 해야 합니다. 콘텐츠를 다른 출력으로 제한하려면 새 스왑 체인을 만들어야 합니다. 그러나 DXGI_PRESENT_RESTRICT_TO_OUTPUT 플래그에 따라 콘텐츠를 조건부로 제한할 수 있습니다.

콘텐츠를 출력 대상으로 제한하지 않으려면 이 매개 변수를 NULL 로 설정합니다.

[out] ppSwapChain

이 메서드가 만드는 스왑 체인에 대한 IDXGISwapChain1 인터페이스에 대한 포인터를 수신하는 변수에 대한 포인터입니다.

반환 값

CreateSwapChainForCompositionSurfaceHandle은 다음을 반환합니다.

• 스왑 체인을 성공적으로 만들었는지 S_OK.
• E_OUTOFMEMORY 메모리를 사용할 수 없는 경우 작업을 완료합니다.
• 호출 애플리케이션이 잘못된 데이터를 제공한 경우(예: pDesc, pYuvDecodeBuffers 또는 ppSwapChain 이 NULL인 경우) DXGI_ERROR_INVALID_CALL.
• pDevice에 전달하는 디바이스 유형에 의해 정의된 DXGI_ERROR 항목에 설명된 다른 오류 코드일 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows 8.1 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	dxgi1_3.h
라이브러리	Dxgi.lib

추가 정보

최상의 성능을 위해 DXGI 대칭 이동 모델을 사용합니다.

IDXGIFactoryMedia