Función HeapVidMemAllocAligned (dmemmgr.h)
La función HeapVidMemAllocAligned asigna off_screen_memory para un controlador de pantalla mediante el administrador del montón de memoria de vídeo de DirectDraw.
Sintaxis
FLATPTR HeapVidMemAllocAligned(
[in] LPVIDMEM lpVidMem,
[in] DWORD dwWidth,
[in] DWORD dwHeight,
[in] LPSURFACEALIGNMENT lpAlignment,
[out] LPLONG lpNewPitch
);
Parámetros
[in] lpVidMem
Puntero a una estructura VIDEOMEMORY que representa el montón de DirectDraw desde el que se va a asignar la superficie.
[in] dwWidth
Es el ancho en bytes de la superficie solicitada.
[in] dwHeight
Es el alto en líneas de examen de la superficie solicitada.
[in] lpAlignment
Puntero a una estructura SURFACEALIGNMENT que describe las restricciones de alineación de la superficie.
[out] lpNewPitch
Es la ubicación en la que se escribe el valor de tono resultante. Esta información solo es relevante para montones lineales (no irretangulares) fuera de la pantalla.
Valor devuelto
HeapVidMemAllocAligned devuelve el desplazamiento FLATPTR de la asignación resultante tras el éxito. De lo contrario, devuelve cero.
Comentarios
El controlador debe usar la matriz de estructuras VIDEOMEMORY que recibe su función DrvGetDirectDrawInfo para determinar el valor de lpVidMem con el que llamar a HeapVidMemAllocAligned. El controlador recibe esta matriz en el parámetro pvmList durante la segunda llamada a DrvGetDirectDrawInfo. Es posible que no se llame a DrvGetDirectDrawInfo cuando existan condiciones de memoria baja en el sistema. Por lo tanto, el controlador siempre debe comprobar para asegurarse de que tiene un puntero distinto de NULL en pvmList.
Requisitos
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Universal |
| Encabezado | dmemmgr.h (incluya Winddi.h) |
| Library | Win32k.lib |
| Archivo DLL | Win32k.sys |