PDRIVER_IO_PORT_UCHAR_STRING función de devolución de llamada (video.h)

Artículo
02/26/2024

SvgaHwIoPortUcharString captura un puerto de E/S al que una aplicación MS-DOS de pantalla completa en una máquina basada en x86 envía una secuencia de datos de tamaño UCHAR.

Sintaxis

PDRIVER_IO_PORT_UCHAR_STRING PdriverIoPortUcharString;

VP_STATUS PdriverIoPortUcharString(
  ULONG_PTR Context,
  ULONG Port,
  UCHAR AccessMode,
  PUCHAR Data,
  ULONG DataLength
)
{...}

Parámetros

Context

Especifica el valor de contexto determinado por el controlador miniport que se estableció en el miembro EmulatorAccessEntriesContext de VIDEO_PORT_CONFIG_INFO.

Port

Especifica el puerto de E/S asignado.

AccessMode

Especifica el tipo de acceso permitido, que puede ser una o una combinación (ORed) de los valores siguientes:

EMULATOR_READ_ACCESS
EMULATOR_WRITE_ACCESS

Data

Puntero a la cadena UCHAR que se va a transferir. Un carácter a la vez se enlaza hasta que se transfiere toda la cadena.

DataLength

Especifica el número de valores UCHAR de la cadena.

Valor devuelto

SvgaHwIoPortUcharString devuelve el estado final de la operación.

Comentarios

Solo los controladores miniporte de adaptadores SVGA compatibles con VGA tienen funciones SvgaHwIoPortXxx . (Consulte Funciones SVGA).

SvgaHwIoPortUcharString intercepta cualquier acceso de bytes intentado por una aplicación MS-DOS de pantalla completa que emite o ambas instrucciones REP OUTSB DX, ESI y REP INSB EDI, DX.

Si el controlador de minipuerto habilita el puerto para el acceso directo llamando a VideoSetTrappedEmulatorPorts, no se llamará a su función SvgaHwIoPortUcharString . Esta aplicación tendrá acceso directo al puerto de E/S, a menos que el controlador de miniporte deshabilite el puerto con otra llamada a VideoSetTrappedEmulatorPorts.

Si una o varias instrucciones de INSB o OUTSB emitidas por la aplicación podrían afectar al estado del registro del secuenciador de adaptadores compatible con VGA, al registro de salida varios o a cualquier registro específico del adaptador y, por lo tanto, hacer que la máquina se bloquee, el controlador de miniporte no debe habilitar el puerto para el acceso directo llamando a VideoPortSetTrappedEmulatorPorts.

SvgaHwIoPortUcharString debe almacenar en búfer las instrucciones posteriores de la aplicación y comprobar que ninguna puede bloquear la máquina. Si la aplicación emite una secuencia de instrucciones que podrían bloquear la máquina, SvgaHwIoPortUcharString debe descartar las instrucciones almacenadas en búfer. De lo contrario, debe generarlos, un UCHAR a la hora, en el puerto de E/S asignado especificado.

SvgaHwIoPortUcharString debe ser paginable.