Función VideoPortAllocateCommonBuffer (video.h)
La función VideoPortAllocateCommonBuffer asigna y asigna memoria del sistema para que sea accesible simultáneamente desde el procesador y un dispositivo para las operaciones DMA de búfer común.
Sintaxis
VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortAllocateCommonBuffer(
[in] IN PVOID HwDeviceExtension,
[in] IN PVP_DMA_ADAPTER VpDmaAdapter,
[in] IN ULONG DesiredLength,
[out] OUT PPHYSICAL_ADDRESS LogicalAddress,
[in] IN BOOLEAN CacheEnabled,
[out] OUT PVOID Reserved
);
Parámetros
[in] HwDeviceExtension
Puntero a la extensión del dispositivo del controlador de minipuerto.
[in] VpDmaAdapter
Puntero a la estructura VP_DMA_ADAPTER que representa el adaptador bus-master. Esta estructura la devolvió una llamada anterior a VideoPortGetDmaAdapter.
[in] DesiredLength
Especifica el número solicitado de bytes de memoria.
[out] LogicalAddress
Puntero a una ubicación de memoria que recibe la dirección lógica que va a usar el adaptador para acceder al búfer asignado.
[in] CacheEnabled
Especifica si la memoria asignada se puede almacenar en caché. Para obtener más información, vea la descripción del parámetro CacheEnabled para AllocateCommonBuffer.
[out] Reserved
Actualmente, el controlador de puerto de vídeo omite el controlador de puerto de vídeo; debe establecerse en NULL.
Valor devuelto
VideoPortAllocateCommonBuffer devuelve la dirección virtual base del búfer asignado si se ejecuta correctamente; de lo contrario, devuelve NULL si no se puede asignar el búfer.
Comentarios
Cuando el búfer ya no es necesario, el controlador de minipuerto de vídeo debe liberarlo llamando a VideoPortReleaseCommonBuffer.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows XP y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | video.h (incluir Video.h) |
| Library | Videoprt.lib |
| Archivo DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |