Compartilhar via

Função DCompositionCreateSurfaceHandle (dcomp.h)

  • Artigo

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:

Valor Significado
0x0000L
 Sem acesso.
COMPOSITIONOBJECT_READ
0x0001L
 Acesso de leitura. Somente para uso interno.
COMPOSITIONOBJECT_WRITE
0x0002L
 Acesso de gravação. Somente para uso interno.
COMPOSITIONOBJECT_ALL_ACCESS
0x0003L
 Acesso de leitura/gravação. Sempre especifique esse sinalizador, exceto ao duplicar uma superfície em outro processo, nesse caso, definir desiredAccess como 0.

[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

Requisito Valor
de cliente com suporte mínimo Windows 8 [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2012 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho dcomp.h
biblioteca Dcomp.lib
de DLL Dcomp.dll