Función DrvGetDirectDrawInfo (winddi.h)

Artículo
08/27/2023

La función DrvGetDirectDrawInfo devuelve las funciones del hardware gráfico.

Sintaxis

BOOL DrvGetDirectDrawInfo(
  DHPDEV      dhpdev,
  DD_HALINFO  *pHalInfo,
  DWORD       *pdwNumHeaps,
  VIDEOMEMORY *pvmList,
  DWORD       *pdwNumFourCCCodes,
  DWORD       *pdwFourCC
);

Parámetros

dhpdev

Identificador del PDEV devuelto por la rutina DrvEnablePDEV del controlador.

pHalInfo

Apunta a una estructura DD_HALINFO en la que el controlador debe devolver las funcionalidades de hardware que admite.

pdwNumHeaps

Apunta a la ubicación en la que el controlador debe devolver el número de estructuras VIDEOMEMORY a las que apunta pvmList.

pvmList

Apunta a una matriz de estructuras VIDEOMEMORY en las que el controlador debe devolver información sobre cada fragmento de memoria para mostrar que controla. El controlador debe omitir este parámetro cuando sea NULL.

pdwNumFourCCCodes

Apunta a la ubicación en la que el controlador debe devolver el número de DWORD a los que apunta pdwFourCC.

pdwFourCC

Apunta a una matriz de DWORD en la que el controlador debe devolver información sobre cada FOURCC que admita. El controlador debe omitir este parámetro cuando sea NULL.

Valor devuelto

DrvGetDirectDrawInfo devuelve TRUE si se realiza correctamente; de lo contrario, devuelve FALSE.

Comentarios

La rutina DrvGetDirectDrawInfo del controlador debe hacer lo siguiente:

Cuando pvmList y pdwFourCC son NULL:
1. Reserve la memoria de visualización fuera de pantalla para el uso de DirectDraw.
2. Escriba el número de montones de memoria para mostrar del controlador y los FOURCC compatibles en pdwNumHeaps y pdwNumFourCC, respectivamente.
Cuando pvmList y pdwFourCC no son NULL:
1. Escriba el número de montones de memoria para mostrar del controlador y los FOURCC compatibles en pdwNumHeaps y pdwNumFourCC, respectivamente.
2. Para cada estructura VIDEOMEMORY de la lista a la que apunta pvmList , rellene los miembros adecuados para describir un fragmento determinado de memoria de visualización. La lista de estructuras proporciona a DirectDraw una descripción completa de la memoria fuera de pantalla del controlador.
Inicialice los miembros de la estructura de DD_HALINFO con información específica del controlador de la siguiente manera:
1. Inicialice los miembros adecuados de la estructura VIDEOMEMORYINFO en vmiData para describir las características generales de la memoria de la pantalla.
2. Inicialice los miembros adecuados de la estructura DDCORECAPS en ddCaps para describir las funcionalidades del hardware.
3. Si el controlador implementa una función DdGetDriverInfo , establezca GetDriverInfo para que apunte a ella y establezca dwFlags en DDHALINFO_GETDRIVERINFOSET.