Função DdGetDxHandle (ddrawgdi.h)

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

Retorna o identificador da API do Microsoft DirectX no modo kernel a ser usado em chamadas subsequentes para os pontos de entrada no modo kernel que controlam o mecanismo de API do DirectX.

GdiEntry14 é definido como um alias para essa função.

Sintaxe

HANDLE DdGetDxHandle(
  [in] LPDDRAWI_DIRECTDRAW_LCL   pDDraw,
  [in] LPDDRAWI_DDRAWSURFACE_LCL pSurface,
  [in] BOOL                      bRelease
);

Parâmetros

[in] pDDraw

Ponteiro para o objeto DirectDraw que possui a superfície. Esse parâmetro é opcional e pode ser definido como NULL.

[in] pSurface

Ponteiro para a superfície para a qual retornar um identificador de API DirectX no modo kernel. Esse parâmetro é opcional e pode ser definido como NULL.

[in] bRelease

Defina como TRUE se a interface do modo kernel da API directx deve ser liberada. Caso contrário, FALSE.

Valor retornado

Um identificador de API do DirectX usado em pontos de entrada de kernel orientados à API do DirectX subsequentes.

Comentários

Se pDDraw e pSurface forem especificados, pSurface será ignorado.

Requisitos

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]
Plataforma de Destino	Windows
Cabeçalho	ddrawgdi.h

Confira também

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