Função NtGdiD3DContextCreate

Artigo
06/13/2023

[Essa função está sujeita a alterações com cada revisão do sistema operacional. Em vez disso, use o Microsoft DirectDraw e o Microsoft Direct3DAPIs; essas APIs isolam os aplicativos dessas alterações do sistema operacional e ocultam muitas outras dificuldades envolvidas na interação diretamente com drivers de exibição.]

Cria um contexto.

Sintaxe

BOOL APIENTRY NtGdiD3DContextCreate(
  _In_    HANDLE                  hDirectDrawLocal,
  _In_    HANDLE                  hSurfColor,
  _In_    HANDLE                  hSurfZ,
  _Inout_ D3DNTHAL_CONTEXTCREATEI *pdcci
);

Parâmetros

hDirectDrawLocal [in]: Manipule para um objeto DirectDraw no modo kernel, criado anteriormente com NtGdiDdCreateDirectDrawObject, representando o dispositivo no qual o contexto Direct3D deve ser criado.
hSurfColor [in]: Manipule para uma estrutura DD_SURFACE_LOCAL que descreve a superfície DirectDraw a ser usada como o destino de renderização.
hSurfZ [in]: Manipule para uma estrutura DD_SURFACE_LOCAL que descreve a superfície DirectDraw a ser usada como um buffer de profundidade. Se esse membro for NULL, nenhum buffer de profundidade será executado.
pdcci [in, out]: Ponteiro para uma estrutura D3DNTHAL_CONTEXTCREATEDATA que contém as informações necessárias para criar um contexto e os dados que o driver deve armazenar no novo contexto.

Valor retornado

NtGdiD3DContextCreate retorna um dos seguintes códigos de retorno de chamada.

Código de retorno	Descrição
DDHAL_DRIVER_HANDLED	O driver executou a operação e retornou um código de retorno válido para essa operação. Se esse código for DD_OK, DirectDraw ou Direct3D prosseguirá com a função . Caso contrário, DirectDraw ou Direct3D retornará o código de erro fornecido pelo driver e anulará a função.
DDHAL_DRIVER_NOTHANDLED	O driver não tem comentários sobre a operação solicitada. Se o driver for necessário para ter implementado um retorno de chamada específico, DirectDraw ou Direct3D relatará uma condição de erro. Caso contrário, DirectDraw ou Direct3D manipula a operação como se o retorno de chamada do driver não tivesse sido definido executando a implementação independente do dispositivo DirectDraw ou Direct3D.

Código de retorno

Descrição

DDHAL_DRIVER_HANDLED

O driver executou a operação e retornou um código de retorno válido para essa operação. Se esse código for DD_OK, DirectDraw ou Direct3D prosseguirá com a função . Caso contrário, DirectDraw ou Direct3D retornará o código de erro fornecido pelo driver e anulará a função.

DDHAL_DRIVER_NOTHANDLED

O driver não tem comentários sobre a operação solicitada. Se o driver for necessário para ter implementado um retorno de chamada específico, DirectDraw ou Direct3D relatará uma condição de erro. Caso contrário, DirectDraw ou Direct3D manipula a operação como se o retorno de chamada do driver não tivesse sido definido executando a implementação independente do dispositivo DirectDraw ou Direct3D.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Ntgdi.h

Confira também

Suporte ao cliente de baixo nível de gráficos