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.

Comentarios

Consulte Bus-Master DMA en controladores de miniporte de vídeo para obtener información sobre las transferencias DMA de búfer común y basada en paquetes.

Requisitos

Consulte también

VideoPortAllocateCommonBuffer