Função NtGdiD3DContextCreate
[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 |
|---|---|
|
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. |
|
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 |
|
Confira também