Fonction DCompositionCreateSurfaceHandle (dcomp.h)

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 :

[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