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。
- 可能是 DXGI_ERROR主題中所述 的其他錯誤碼，這些錯誤碼是由您傳遞至 pDevice的裝置類型所定義。
需求
| 最低支援的用戶端 | Windows 8.1 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 R2 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | dxgi1_3.h |
| 程式庫 | Dxgi.lib |