PI8042_SYNCH_READ_PORT função de retorno de chamada (ntdd8042.h)

Artigo
02/07/2025

A rotina de retorno de chamada do tipo PI8042_SYNCH_READ_PORT faz uma leitura sincronizada de uma porta i8042. O I8042prt fornece esse retorno de chamada.

Sintaxe

PI8042_SYNCH_READ_PORT Pi8042SynchReadPort;

NTSTATUS Pi8042SynchReadPort(
  [in]  PVOID Context,
  [out] PUCHAR Value,
  [in]  BOOLEAN WaitForACK
)
{...}

Parâmetros

[in] Context

Ponteiro para um contexto fornecido pelo I8042prt.

[out] Value

Ponteiro para o valor UCHAR retornado pela rotina.

[in] WaitForACK

Não usado.

Valor de retorno

O retorno de chamada PI8042_SYNCH_READ_PORT retorna um dos seguintes valores de status:

Código de retorno	Descrição
STATUS_SUCCESS	A rotina retornou com êxito um byte.
STATUS_IO_TIMEOUT	O hardware não estava pronto para um acesso de leitura.

Observações

O retorno de chamada PI8042_SYNCH_READ_PORT só pode ser usado em um retorno de chamada PI8042_KEYBOARD_INITIALIZATION_ROUTINE. O I8042prt especifica o retorno de chamada de porta de leitura no parâmetro ReadPort que o I8042prt inseriu em uma rotina de inicialização de teclado.

A rotina sonda o hardware até que uma leitura seja retornada pelo hardware ou ocorra um tempo limite interno.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	ntdd8042.h (inclua Ntdd8042.h)
IRQL	PASSIVE_LEVEL

Consulte também

PI8042_KEYBOARD_INITIALIZATION_ROUTINE

PI8042_SYNCH_WRITE_PORT

Compartilhar via