DCompositionCreateSurfaceHandle, fonction (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é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 :

[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