Función VideoPortAllocateContiguousMemory (video.h)

La función VideoPortAllocateContiguousMemory está obsoleta en Windows 2000 y versiones posteriores. Los controladores de minipuerto de vídeo deben usar VideoPortAllocateCommonBuffer en su lugar.

VideoPortAllocateContiguousMemory asigna un intervalo de memoria físicamente contigua y alineada con caché del grupo no paginado.

Sintaxis

VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortAllocateContiguousMemory(
  [in] IN PVOID            HwDeviceExtension,
  [in] IN ULONG            NumberOfBytes,
  [in] IN PHYSICAL_ADDRESS HighestAcceptableAddress
);

Parámetros

[in] HwDeviceExtension

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

[in] NumberOfBytes

Especifica el tamaño en bytes del bloque de memoria contigua que se va a asignar.

[in] HighestAcceptableAddress

Especifica la dirección física válida más alta que el controlador de miniporte puede usar. Por ejemplo, si un dispositivo solo puede hacer referencia a la memoria física en los 16 MB inferiores, este valor se establecería en 0x00000000FFFFFF.

Valor devuelto

VideoPortAllocateContiguousMemory devuelve la dirección virtual base de la memoria asignada, si la llamada se realiza correctamente. Si no se puede satisfacer la solicitud, se devuelve NULL .

Comentarios

Se puede llamar a VideoPortAllocateContiguousMemory para asignar un bloque contiguo de memoria física para un búfer interno a largo plazo.

Un controlador de minipuerto que debe usar memoria contigua solo debe asignar lo que necesita durante la inicialización del controlador, ya que es probable que el grupo no paginado se fragmente a medida que se ejecuta el sistema. Si el controlador de minipuerto se descarga, debe desasignar la memoria. Las asignaciones contiguas se alinean en un múltiplo entero del tamaño de la línea de caché de datos del procesador para evitar problemas de caché y coherencia.

Requisitos

Consulte también

VideoPortAllocateBuffer