PDRIVER_IO_PORT_UCHAR função de retorno de chamada (video.h)

Artigo
03/01/2024

SvgaHwIoPortUchar intercepta uma porta de E/S para a qual um aplicativo MS-DOS de tela inteira em um computador baseado em x86 está enviando dados do tamanho de UCHAR.

Sintaxe

PDRIVER_IO_PORT_UCHAR PdriverIoPortUchar;

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

Parâmetros

Context

Especifica o valor de contexto definido pelo driver de miniport que foi definido no membro EmulatorAccessEntriesContext do VIDEO_PORT_CONFIG_INFO.

Port

Especifica a porta de E/S mapeada a ser presa.

AccessMode

Especifica o tipo de acesso a ser interceptado, que pode ser uma ou uma combinação (ORed) dos seguintes valores:

EMULATOR_READ_ACCESS
EMULATOR_WRITE_ACCESS

Data

Ponteiro para o byte a ser transferido.

Retornar valor

SvgaHwIoPortUchar retorna a status final da operação.

Comentários

Somente drivers de miniporta de adaptadores SVGA compatíveis com VGA têm funções SvgaHwIoPortXxx . (Consulte Funções SVGA.)

SvgaHwIoPortUchar intercepta qualquer acesso de byte tentado por um aplicativo MS-DOS de tela inteira que emite ou ambas as instruções OUT DX, AL e IN AL, DX.

Se o driver de miniporto habilitar a Porta para acesso direto chamando VideoPortSetTrappedEmulatorPorts, sua função SvgaHwIoPortUchar não será chamada. Em seguida, esse aplicativo terá acesso direto à Porta, a menos que o driver de miniporta desabilite a Porta com outra chamada para VideoPortSetTrappedEmulatorPorts.

Se uma ou mais instruções X86 IN ou OUT emitidas pelo aplicativo puderem afetar o estado do registro do sequenciador de adaptador compatível com VGA, o registro de saída diverso ou qualquer registro específico do adaptador e, assim, causar o travamento do computador, o driver de miniporto não deverá habilitar a porta para acesso direto chamando VideoPortSetTrappedEmulatorPorts.

SvgaHwIoPortUchar deve armazenar em buffer as instruções subsequentes do aplicativo para a Porta e marcar que nenhuma pode travar o computador. Se o aplicativo emitir qualquer sequência de instruções que possam travar o computador, SvgaHwIoPortUchar deverá descartar as instruções armazenadas em buffer. Caso contrário, ele deverá gerá-los, um UCHAR por vez, para a porta de E/S mapeada especificada.

SvgaHwIoPortUchar deve ser tornado paginável.