Partilhar via


Função D3DKMTCreateDCFromMemory (d3dkmthk.h)

A função D3DKMTCreateDCFromMemory cria um contexto de exibição de um bloco de memória especificado.

Sintaxe

NTSTATUS D3DKMTCreateDCFromMemory(
  D3DKMT_CREATEDCFROMMEMORY *unnamedParam1
);

Parâmetros

unnamedParam1

pData [dentro, fora]

Um ponteiro para uma estrutura de D3DKMT_CREATEDCFROMMEMORY que descreve parâmetros para criar um contexto de exibição.

Valor de retorno

D3DKMTCreateDCFromMemory retorna um dos seguintes valores:

Código de retorno Descrição
STATUS_SUCCESS O contexto de exibição foi criado com êxito.
STATUS_INVALID_PARAMETER Os parâmetros foram validados e determinados como incorretos.

Essa função também pode retornar outros valores de NTSTATUS .

Observações

O kernel controla a memória referenciada pelo contexto de exibição criado pela função D3DKMTCreateDCFromMemory. Você deve chamar a função D3DKMTDestroyDCFromMemory para liberar a memória referenciada pelo contexto de exibição. Qualquer outra abordagem para liberar essa memória falhará.

Durante a execução da função D3DKMTCreateDCFromMemory, o kernel bloqueia e investiga a memória referenciada executando uma gravação segura não thread em cada página na memória. Nenhum outro thread em seu processo deve tentar acessar qualquer parte dessa memória durante a chamada D3DKMTCreateDCFromMemory; caso contrário, os resultados serão indefinidos.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista
da Plataforma de Destino Universal
cabeçalho d3dkmthk.h (inclua D3dkmthk.h)
biblioteca Gdi32.lib
de DLL Gdi32.dll

Consulte também

D3DKMT_CREATEDCFROMMEMORY