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

Artigo
02/29/2024

O SvgaHwIoPortUlong intercepta um intervalo de portas de E/S para o qual um aplicativo MS-DOS de tela inteira em um computador baseado em x86 está enviando uma sequência de dados de tamanho ULONG.

Sintaxe

PDRIVER_IO_PORT_ULONG PdriverIoPortUlong;

VP_STATUS PdriverIoPortUlong(
  ULONG_PTR Context,
  ULONG Port,
  UCHAR AccessMode,
  PULONG Data
)
{...}

Parâmetros

Context

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

Port

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

AccessMode

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

EMULATOR_READ_ACCESS
EMULATOR_WRITE_ACCESS

Data

Ponteiro para os dados ULONG a serem transferidos.

Retornar valor

SvgaHwIoPortUlong 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.)

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

Se o driver de miniporto habilitar o intervalo de portas para acesso direto chamando VideoSetTrappedEmulatorPorts, sua função SvgaHwIoPortUlong não será chamada. Em seguida, esse aplicativo terá acesso direto ao intervalo de portas de E/S, a menos que o driver de miniporta desabilite o intervalo com outra chamada para VideoSetTrappedEmulatorPorts.

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.

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

SvgaHwIoPortUlong deve ser tornado paginável.