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 |
---|---|
|
The routine successfully wrote a byte to an i8042 port. |
|
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 |