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 |