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 de 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 de para AllocateCommonBuffer.
[out] Reserved
Actualmente se omite mediante 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.
Observaciones
Cuando ya no se necesite el búfer, el controlador de miniporte de vídeo debe liberarlo llamando a VideoPortReleaseCommonBuffer.
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 | PASSIVE_LEVEL |