Méthode IDXGIFactoryMedia::CreateSwapChainForCompositionSurfaceHandle (dxgi1_3.h)

Article
08/23/2023

Crée une chaîne d’échange YUV pour une poignée de surface DirectComposition existante.

Syntaxe

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

Paramètres

[in] pDevice

Pointeur vers l’appareil Direct3D pour la chaîne d’échange. Ce paramètre ne peut pas être NULL. Les pilotes logiciels, comme D3D_DRIVER_TYPE_REFERENCE, ne sont pas pris en charge pour les chaînes d’échange de composition.

[in, optional] hSurface

Handle vers une surface DirectComposition existante. Ce paramètre ne peut pas être NULL.

[in] pDesc

Pointeur vers une structure DXGI_SWAP_CHAIN_DESC1 pour la description de la chaîne d’échange. Ce paramètre ne peut pas être NULL.

[in, optional] pRestrictToOutput

Pointeur vers l’interface IDXGIOutput pour la chaîne d’échange à laquelle restreindre le contenu. Si la chaîne d’échange est déplacée vers une autre sortie, le contenu est noir. Vous pouvez éventuellement définir ce paramètre sur une cible de sortie qui utilise DXGI_PRESENT_RESTRICT_TO_OUTPUT pour restreindre le contenu de cette sortie. Si la chaîne d’échange est déplacée vers une autre sortie, le contenu est noir.

Vous devez également passer l’indicateur DXGI_PRESENT_RESTRICT_TO_OUTPUT dans un appel présent pour forcer le contenu à apparaître noirci sur toute autre sortie. Si vous souhaitez limiter le contenu à une sortie différente, vous devez créer une chaîne d’échange. Toutefois, vous pouvez restreindre de manière conditionnelle le contenu en fonction de l’indicateur DXGI_PRESENT_RESTRICT_TO_OUTPUT .

Définissez ce paramètre sur NULL si vous ne souhaitez pas restreindre le contenu à une cible de sortie.

[out] ppSwapChain

Pointeur vers une variable qui reçoit un pointeur vers l’interface IDXGISwapChain1 pour la chaîne d’échange créée par cette méthode.

Valeur retournée

CreateSwapChainForCompositionSurfaceHandle retourne :

S_OK s’il a correctement créé une chaîne d’échange.
E_OUTOFMEMORY si la mémoire n’est pas disponible pour terminer l’opération.
DXGI_ERROR_INVALID_CALL si l’application appelante a fourni des données non valides, par exemple, si pDesc, pYuvDecodeBuffers ou ppSwapChain a la valeur NULL.
Peut-être d’autres codes d’erreur décrits dans la rubrique DXGI_ERROR qui sont définis par le type d’appareil que vous passez à pDevice.

Spécifications


Client minimal pris en charge	Windows 8.1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	dxgi1_3.h
Bibliothèque	Dxgi.lib

Voir aussi

Pour de meilleures performances, utilisez le modèle de retournement DXGI

IDXGIFactoryMedia

Partager via