Función VideoPortAllocateContiguousMemory (video.h)
La función VideoPortAllocateContiguousMemory es obsoletos 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 alineada 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 más alta válida que puede usar el controlador de miniport. 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 para la memoria asignada, si la llamada se realiza correctamente. Si no se puede satisfacer la solicitud, se devuelve NULL.
Observaciones
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 miniporte 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 miniporte 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 de coherencia.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows 2000 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 | PASSIVE_LEVEL |