PI8042_SYNCH_WRITE_PORT callback function (ntdd8042.h)

The PI8042_SYNCH_READ_PORT-typed callback routine does a synchronized write to an i8042 port. I8042prt supplies this routine.

Syntax

PI8042_SYNCH_WRITE_PORT Pi8042SynchWritePort;

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

Parameters

[in] Context

Pointer to a context supplied by I8042prt.

[in] Value

Specifies the UCHAR value to write to an i8042 port.

[in] WaitForACK

Specifies, if TRUE, that the routine waits until the write is acknowledged by the i8042 port. Otherwise, the routine returns without waiting for an acknowledgment from the port.

Return value

The PI8042_SYNCH_WRITE_PORT callback returns one of the following status values:

Return code Description
STATUS_SUCCESS
The routine successfully wrote a byte to an i8042 port.
STATUS_IO_TIMEOUT
The hardware was not ready for a write access.

Remarks

The PI8042_SYNCH_READ_PORT callback can only be used in a PI8042_KEYBOARD_INITIALIZATION_ROUTINE callback. I8042prt specifies the write port callback in the WritePort parameter that I8042prt inputs to a keyboard initialization routine.

The routine polls the hardware until a read is returned by the hardware or an internal time-out occurs.

Requirements

Requirement Value
Target Platform Desktop
Header ntdd8042.h (include Ntdd8042.h)
IRQL PASSIVE_LEVEL

See also

PI8042_KEYBOARD_INITIALIZATION_ROUTINE

PI8042_SYNCH_READ_PORT