PI8042_SYNCH_WRITE_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 gravação sincronizada em uma porta i8042. O I8042prt fornece essa rotina.

Sintaxe

PI8042_SYNCH_WRITE_PORT Pi8042SynchWritePort;

NTSTATUS Pi8042SynchWritePort(
  [in] PVOID Context,
  [in] UCHAR Value,
  [in] BOOLEAN WaitForACK
)
{...}

Parâmetros

[in] Context

Ponteiro para um contexto fornecido pelo I8042prt.

[in] Value

Especifica o valor UCHAR a ser gravado em uma porta i8042.

[in] WaitForACK

Especifica, se VERDADEIRO, que a rotina aguarda até que a gravação seja confirmada pela porta i8042. Caso contrário, a rotina retornará sem aguardar uma confirmação da porta.

Valor de retorno

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

Código de retorno	Descrição
STATUS_SUCCESS	A rotina escreveu com êxito um byte em uma porta i8042.
STATUS_IO_TIMEOUT	O hardware não estava pronto para um acesso de gravação.

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 da porta de gravação no parâmetro WritePort 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_READ_PORT

Compartilhar via