Função NtGdiD3DDrawPrimitives2

[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.]

Renderiza primitivos e retorna o estado de renderização atualizado.

Sintaxe

DWORD APIENTRY NtGdiD3DDrawPrimitives2(
  _In_    HANDLE                         hCmdBuf,
  _In_    HANDLE                         hVBuf,
  _Inout_ LPD3DNTHAL_DRAWPRIMITIVES2DATA pded,
  _Inout_ FLATPTR                        *pfpVidMemCmd,
  _Inout_ DWORD                          *pdwSizeCmd,
  _Inout_ FLATPTR                        *pfpVidMemVtx,
  _Inout_ DWORD                          *pdwSizeVtx
);

Parâmetros

hCmdBuf [in]

Manipule para a estrutura DD_SURFACE_LOCAL que identifica a superfície DirectDraw que contém os dados de comando.

hVBuf [in]

Manipule para a estrutura DD_SURFACE_LOCAL que identifica a superfície DirectDraw que contém os dados de vértice.

pded [in, out]

Ponteiro para uma estrutura D3DNTHAL_DRAWPRIMITIVES2DATA que contém as informações necessárias para o driver renderizar um ou mais primitivos.

pfpVidMemCmd [in, out]

Novo ponteiro para memória de vídeo se o driver tiver trocado o buffer de comando.

pdwSizeCmd [in, out]

Especifica o número mínimo de bytes pelos quais o driver deve aumentar o buffer de comando de troca.

pfpVidMemVtx [in, out]

Novo ponteiro para memória de vídeo se o driver tiver trocado o buffer de vértice.

pdwSizeVtx [in, out]

Especifica o número mínimo de bytes que o driver deve alocar para o buffer de vértice de troca.

Valor retornado

NtGdiD3DDrawPrimitives2 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 continuará 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 precisar ter implementado um retorno de chamada específico, DirectDraw ou Direct3D relatará uma condição de erro. Caso contrário, o DirectDraw ou o 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