Metodo IDXGIFactoryMedia::CreateSwapChainForCompositionSurfaceHandle (dxgi1_3.h)

Articolo
08/23/2023

Crea una catena di scambio YUV per un handle di superficie DirectComposition esistente.

Sintassi

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

Parametri

[in] pDevice

Puntatore al dispositivo Direct3D per la catena di scambio. Questo parametro non può essere NULL. I driver software, come D3D_DRIVER_TYPE_REFERENCE, non sono supportati per le catene di scambio di composizione.

[in, optional] hSurface

Handle in una superficie DirectComposition esistente. Questo parametro non può essere NULL.

[in] pDesc

Puntatore a una struttura DXGI_SWAP_CHAIN_DESC1 per la descrizione della catena di scambio. Questo parametro non può essere NULL.

[in, optional] pRestrictToOutput

Puntatore all'interfaccia IDXGIOutput per la catena di scambio a cui limitare il contenuto. Se la catena di scambio viene spostata in un output diverso, il contenuto è nero. Facoltativamente, è possibile impostare questo parametro su una destinazione di output che usa DXGI_PRESENT_RESTRICT_TO_OUTPUT per limitare il contenuto in questo output. Se la catena di scambio viene spostata in un output diverso, il contenuto è nero.

È inoltre necessario passare il flag DXGI_PRESENT_RESTRICT_TO_OUTPUT in una chiamata presente per forzare la visualizzazione del contenuto in nero in qualsiasi altro output. Se si vuole limitare il contenuto a un output diverso, è necessario creare una nuova catena di scambio. Tuttavia, è possibile limitare in modo condizionale il contenuto in base al flag di DXGI_PRESENT_RESTRICT_TO_OUTPUT .

Impostare questo parametro su NULL se non si vuole limitare il contenuto a una destinazione di output.

[out] ppSwapChain

Puntatore a una variabile che riceve un puntatore all'interfaccia IDXGISwapChain1 per la catena di scambio creata da questo metodo.

Valore restituito

CreateSwapChainForCompositionSurfaceHandle restituisce :

S_OK se è stata creata correttamente una catena di scambio.
E_OUTOFMEMORY se la memoria non è disponibile per completare l'operazione.
DXGI_ERROR_INVALID_CALL se l'applicazione chiamante ha fornito dati non validi, ad esempio se pDesc, pYuvDecodeBuffers o ppSwapChain è NULL.
Possibilmente altri codici di errore descritti nell'argomento DXGI_ERROR definiti dal tipo di dispositivo passato a pDevice.

Requisiti


Client minimo supportato	Windows 8.1 [solo app desktop]
Server minimo supportato	Windows Server 2012 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	dxgi1_3.h
Libreria	Dxgi.lib

Vedi anche

Per ottenere prestazioni ottimali, usare il modello flip DXGI

IDXGIFactoryMedia

Condividi tramite