Partager via

Fonction DCompositionCreateSurfaceHandle (dcomp.h)

  • Article

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