Función DdCreateDirectDrawObject (ddrawgdi.h)

[Esta función está sujeta a cambios con cada revisión del sistema operativo. En su lugar, use DirectDraw y Microsoft Direct3DAPIs; estas API aíslan las aplicaciones de estos cambios en el sistema operativo y ocultan muchas otras dificultades implicadas en la interacción directa con los controladores de pantalla.

Contenedor para la función NtGdiDdCreateDirectDrawObject y crea una representación del lado kernel del objeto Microsoft DirectDraw. Un identificador de esta representación se almacenará en pDirectDrawGlobal-hDD>.

GdiEntry1 se define como un alias para esta función.

Sintaxis

BOOL DdCreateDirectDrawObject(
  LPDDRAWI_DIRECTDRAW_GBL pDirectDrawGlobal,
  HDC                     hdc
);

Parámetros

pDirectDrawGlobal

Puntero al objeto DirectDraw en modo de usuario. Consulte la documentación de DDK para obtener más información.

hdc

Identificador del controlador de dominio para el dispositivo para el que se crea esta representación. Si es 0, el dispositivo será el dispositivo "mostrar". Tenga en cuenta que esta función conserva solo un objeto DirectDraw "display" y devolverá un identificador copiado a ese mismo objeto si posteriormente se llama con hdc = 0.

Valor devuelto

Si se ejecuta correctamente, esta función devuelve TRUE; de lo contrario, devuelve FALSE.

Comentarios

Se recomienda a las aplicaciones usar las API de DirectDraw y Direct3D para crear y administrar objetos de dispositivo gráficos. Estas construcciones abstraen el proceso de creación de dispositivos de forma simplificada e independiente del sistema operativo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ddrawgdi.h

Consulte también

Compatibilidad con clientes de bajo nivel de gráficos