Fonction DCompositionCreateSurfaceHandle (dcomp.h)

Article
03/01/2024

Crée un objet de surface de composition qui peut être lié à une chaîne d’échange Microsoft DirectX ou à une mémoire tampon d’échange et associé à un visuel.

Syntaxe

HRESULT DCompositionCreateSurfaceHandle(
  [in]           DWORD               desiredAccess,
  [in, optional] SECURITY_ATTRIBUTES *securityAttributes,
  [out]          HANDLE              *surfaceHandle
);

Paramètres

[in] desiredAccess

Type : DWORD

Accès demandé à l’objet surface de composition. Ce peut être l’une des valeurs suivantes :

Valeur	Signification
0x0000L	Pas d'accès.
COMPOSITIONSURFACE_READ 0x0001L	Accès en lecture. À usage interne uniquement.
COMPOSITIONSURFACE_WRITE 0x0002L	Accès en écriture. À usage interne uniquement.
COMPOSITIONSURFACE_ALL_ACCESS 0x0003L	Accès en lecture/écriture. Spécifiez toujours cet indicateur, sauf lors de la duplication d’une surface dans un autre processus, auquel cas définissez desiredAccess sur 0.

[in, optional] securityAttributes

Type : SECURITY_ATTRIBUTES*

Contient le descripteur de sécurité pour l’objet surface de composition et spécifie si le handle de l’objet surface de composition est héritable lors de la création d’un processus enfant. Si ce paramètre a la valeur NULL, l’objet surface de composition est créé avec des attributs de sécurité par défaut qui accordent l’accès en lecture et en écriture au processus actuel, mais ne permettent pas aux processus enfants d’hériter du handle.

[out] surfaceHandle

Type : HANDLE*

Handle du nouvel objet surface de composition. Ce paramètre ne doit pas avoir la valeur NULL.

Valeur retournée

Type : HRESULT

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur DirectComposition .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	dcomp.h
Bibliothèque	Dcomp.lib
DLL	Dcomp.dll

Partager via