Compartilhar via


Função DCompositionCreateSurfaceHandle (dcomp.h)

Cria um novo objeto de superfície de composição que pode ser associado a uma cadeia de troca ou buffer de troca do Microsoft DirectX 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.
COMPOSITIONSURFACE_READ
0x0001L
Acesso de leitura. Apenas para uso interno.
COMPOSITIONSURFACE_WRITE
0x0002L
Acesso de gravação. Apenas para uso interno.
COMPOSITIONSURFACE_ALL_ACCESS
0x0003L
Acesso de leitura/gravação. Sempre especifique esse sinalizador, exceto ao duplicar uma superfície em outro processo, nesse caso, defina desiredAccess como 0.

[in, optional] securityAttributes

Tipo: SECURITY_ATTRIBUTES*

Contém o descritor de segurança para o objeto de superfície de composição e especifica se o identificador do objeto de superfície de composição é herdado 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 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.

Retornar valor

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 Códigos de Erro do DirectComposition para obter uma lista de códigos de erro.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho dcomp.h
Biblioteca Dcomp.lib
DLL Dcomp.dll