Función VideoPortGetCommonBuffer (video.h)
La función VideoPortGetCommonBuffer está obsoleta en Windows XP y versiones posteriores, y solo se admite para la compatibilidad con versiones anteriores con controladores existentes. En su lugar, los escritores de controladores deben usar VideoPortAllocateCommonBuffer.
VideoPortGetCommonBuffer 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 VideoPortGetCommonBuffer(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG DesiredLength,
[in] IN ULONG Alignment,
[out] OUT PPHYSICAL_ADDRESS LogicalAddress,
[out] OUT PULONG pActualLength,
[in] IN BOOLEAN CacheEnabled
);
Parámetros
[in] HwDeviceExtension
Puntero a la extensión del dispositivo del controlador de minipuerto.
[in] DesiredLength
Especifica el número solicitado de bytes de memoria.
[in] Alignment
Especifica la alineación solicitada del búfer. Actualmente, el controlador de puerto de vídeo omite este parámetro.
[out] LogicalAddress
Puntero a una variable que recibe la dirección lógica que va a usar el adaptador para acceder al búfer asignado.
[out] pActualLength
Puntero a una variable que recibe el tamaño real, en bytes, del búfer asignado para esta solicitud.
[in] CacheEnabled
Especifica si la memoria asignada se puede almacenar en caché.
Valor devuelto
VideoPortGetCommonBuffer 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
Consulte Bus-Master DMA en controladores de miniportar de vídeo para obtener información sobre las transferencias DMA de DMA basadas en paquetes y búferes comunes.
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 |