Função DCompositionCreateSurfaceHandle (dcomp.h)

Cria um novo objeto de superfície de composição que pode ser associado a uma cadeia de troca do Microsoft DirectX ou buffer de troca e associado a um visual.

Sintaxe

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

Parâmetros

[in] desiredAccess

Tipo: DWORD

O acesso solicitado ao objeto de superfície de composição. Pode ser um dos seguintes valores:

[in, optional] securityAttributes

Tipo: SECURITY_ATTRIBUTES*

Contém o descritor de segurança do objeto de superfície de composição e especifica se o identificador do objeto de superfície de composição é herdável quando um processo filho é criado. Se esse parâmetro for NULL, o objeto de superfície de composição será criado com atributos de segurança padrão que concedem acesso de leitura e gravação ao processo atual, mas não permitem que os processos filho herdem o identificador.

[out] surfaceHandle

Tipo: HANDLE*

O identificador do novo objeto de superfície de composição. Esse parâmetro não deve ser NULL.

Valor de retorno

Tipo: HRESULT

Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT. Consulte de códigos de erro do DirectComposition para obter uma lista de códigos de erro.

Requisitos