PDRIVER_IO_PORT_UCHAR_STRING função de retorno de chamada (video.h)
SvgaHwIoPortUcharString intercepta uma porta de E/S para a qual um aplicativo MS-DOS de tela inteira em um computador baseado em x86 está enviando uma sequência de dados do tamanho de UCHAR.
Sintaxe
PDRIVER_IO_PORT_UCHAR_STRING PdriverIoPortUcharString;
VP_STATUS PdriverIoPortUcharString(
ULONG_PTR Context,
ULONG Port,
UCHAR AccessMode,
PUCHAR Data,
ULONG DataLength
)
{...}
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.
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 a cadeia de caracteres UCHAR a ser transferida. Um caractere de cada vez é fisgado até que toda a cadeia de caracteres seja transferida.
DataLength
Especifica o número de valores UCHAR na cadeia de caracteres.
Retornar valor
SvgaHwIoPortUcharString 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.)
SvgaHwIoPortUcharString intercepta qualquer acesso de byte tentado por um aplicativo MS-DOS de tela inteira que emite ou ambas as instruções REP OUTSB DX, ESI e REP INSB EDI, DX.
Se o driver de miniporto habilitar a Porta para acesso direto chamando VideoSetTrappedEmulatorPorts, sua função SvgaHwIoPortUcharString não será chamada. Em seguida, esse aplicativo terá acesso direto à porta de E/S, a menos que o driver de miniporta desabilite a porta com outra chamada para VideoSetTrappedEmulatorPorts.
Se uma ou mais instruções de INSB ou OUTSB x86 emitidas pelo aplicativo podem afetar o estado do registro do sequenciador de adaptador compatível com VGA, o registro de saída diversos ou qualquer registro específico do adaptador e, assim, fazer com que o computador seja travado, o driver de miniporto não deverá habilitar a porta para acesso direto chamando VideoPortSetTrappedEmulatorPorts.
SvgaHwIoPortUcharString deve armazenar em buffer as instruções subsequentes do aplicativo e marcar que nenhuma pode travar o computador. Se o aplicativo emitir qualquer sequência de instruções que possam travar o computador, SvgaHwIoPortUcharString 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.
SvgaHwIoPortUcharString deve ser tornado paginável.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | video.h (incluir Video.h) |