Función VideoPortAllocatePool (video.h)

La función VideoPortAllocatePool asigna un bloque de memoria del grupo, insertando una etiqueta proporcionada por el autor de la llamada al principio de la memoria.

Sintaxis

VIDEOPORT_API PVOID VideoPortAllocatePool(
  [in] IN PVOID        HwDeviceExtension,
  [in] IN VP_POOL_TYPE PoolType,
  [in] IN SIZE_T       NumberOfBytes,
  [in] IN ULONG        Tag
);

Parámetros

[in] HwDeviceExtension

Puntero a la extensión del dispositivo del controlador de minipuerto.

[in] PoolType

Especifica el tipo de grupo de memoria que se va a asignar. Este parámetro se puede establecer en uno de los siguientes:

Valor	Significado
VpNonPagedPool	El grupo es de memoria no paginada.
VpPagedPool	El grupo procede de la memoria paginada.
VpNonPagedPoolCacheAligned	El grupo procede de la memoria alineada a la memoria caché y no paginada.
VpPagedPoolCacheAligned	El grupo procede de la memoria paginada alineada a la memoria caché.

[in] NumberOfBytes

Especifica el número de bytes de memoria que se van a asignar.

[in] Tag

Especifica una etiqueta de asignación de cuatro bytes, que consta de hasta cuatro caracteres ASCII, que identifica de forma única el controlador que asigna la memoria. La cadena de etiqueta se delimita con comillas simples.

Valor devuelto

Al asignar correctamente el grupo de memoria, VideoPortAllocatePool devuelve la dirección del grupo de memoria asignado. De lo contrario, esta función devuelve null.

Observaciones

VideoPortAllocatePool está diseñado para reemplazar VideoPortAllocateBuffer, que está obsoleto.

La cadena etiqueta debe especificarse en orden de bytes invertido. Se recomienda que la primera letra de la cadena (antes de invertirla) sea "D" para indicar un controlador de pantalla; los otros tres bytes deben indicar el nombre del controlador. Por ejemplo, la etiqueta cadena "zyxD" aparece como "Dxyz" si el grupo está volcado. La etiqueta aparece en cualquier volcado de memoria del sistema que se produzca.

Los autores de llamadas de VideoPortAllocatePool se pueden ejecutar en IRQL = DISPATCH_LEVEL solo si el Pool Type solicitado es uno de los tipos de VpNonPagedXxx. De lo contrario, los autores de llamadas deben ejecutarse en irQL < DISPATCH_LEVEL.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Windows XP y versiones posteriores de los sistemas operativos Windows.
de la plataforma de destino de	Escritorio
encabezado de	video.h (incluya Video.h)
biblioteca de	Videoprt.lib
DLL de	Videoprt.sys
irQL	Consulte la sección Comentarios.

Consulte también

VideoPortFreePool