Função NtGdiDdCreateD3DBuffer

Artigo
06/03/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.]

Usado para criar um comando no nível do driver ou um buffer de vértice da descrição especificada.

Sintaxe

DWORD APIENTRY NtGdiDdCreateD3DBuffer(
  _In_    HANDLE               hDirectDraw,
  _Inout_ HANDLE               *hSurface,
  _Inout_ DDSURFACEDESC        *puSurfaceDescription,
  _Inout_ DD_SURFACE_GLOBAL    *puSurfaceGlobalData,
  _Inout_ DD_SURFACE_LOCAL     *puSurfaceLocalData,
  _Inout_ DD_SURFACE_MORE      *puSurfaceMoreData,
  _Inout_ DD_CREATESURFACEDATA *puCreateSurfaceData,
  _Inout_ HANDLE               *puhSurface
);

Parâmetros

hDirectDraw [in]: Identificador para a estrutura DD_DIRECTDRAW_GLOBAL que representa o driver.
hSurface [in, out]: Ponteiro para uma matriz de alças de superfície. O chamador poderá definir esses identificadores para os valores de identificador anteriores se as superfícies estiverem sendo recriadas após uma opção de modo. Esse processo é chamado de "restauração" na documentação do DirectDraw.
puSurfaceDescription [in, out]: Ponteiro para uma estrutura DDSURFACEDESC que descreve a superfície ou o buffer que o driver deve criar.
puSurfaceGlobalData [in, out]: Ponteiro para uma estrutura DD_SURFACE_GLOBAL que contém dados de superfície que são compartilhados globalmente com várias superfícies.
puSurfaceLocalData [in, out]: Ponteiro para uma lista de estruturas de DD_SURFACE_LOCAL que descrevem os objetos de superfície criados pelo driver. Geralmente, há apenas uma entrada nessa matriz.
puSurfaceMoreData [in, out]: Ponteiro para uma estrutura DD_SURFACE_MORE que contém dados adicionais da superfície local.
puCreateSurfaceData [in, out]: Ponteiro para uma estrutura DD_CREATESURFACEDATA que contém as informações necessárias para criar o buffer.
puhSurface [entrada, saída]: É usado pela API do DirectDraw e não deve ser preenchido pelo driver.

Retornar valor

NtGdiDdCreateD3DBuffer 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.

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