Partager via

DCompositionCreateSurfaceHandle, fonction (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ée à 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. Il peut s’agir de l’une des valeurs suivantes :

Valeur Signification
0x0000L
 Aucun accès.
COMPOSITIONOBJECT_READ
0x0001L
 Accès en lecture. Pour une utilisation interne uniquement.
COMPOSITIONOBJECT_WRITE
0x0002L
 Accès en écriture. Pour une utilisation interne uniquement.
COMPOSITIONOBJECT_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 iredAccess sur 0.

[in, optional] securityAttributes

Type : SECURITY_ATTRIBUTES*

Contient le descripteur de sécurité de l’objet surface de composition et spécifie si le handle de l’objet de surface de composition est hérité lorsqu’un processus enfant est créé. 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 n’autorisent pas les processus enfants à hériter du handle.

[out] surfaceHandle

Type : HANDLE*

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

Valeur de retour

Type : HRESULT

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

Exigences

Exigence Valeur
client minimum pris en charge Windows 8 [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2012 [applications de bureau uniquement]
plateforme cible Windows
d’en-tête dcomp.h
bibliothèque Dcomp.lib
DLL Dcomp.dll