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

Consulte también

DrvGetDirectDrawInfo

SURFACEALIGNMENT

VIDEOMEMORY

VidMemFree