SerCx Event Callback Functions

This section describes the event callback functions that are defined by version 1 of the serial framework extension (SerCx). These functions are implemented by your serial controller driver. SerCx calls these functions to communicate with the controller driver. All SerCx DDI callback functions that can return status codes return NTSTATUS values. The callback functions in the SerCx DDI are defined in the Sercx.h header file in the Windows 8 version of the Windows Driver Kit (WDK).

Note  Starting with Windows 8.1, version 2 of the serial framework extension (SerCx2) replaces SerCx. New serial controller drivers that are intended to run only on Windows 8.1 and later versions of Windows should be written to use the SerCx2 device driver interface (DDI) instead of the SerCx DDI. However, Windows 8.1 and later versions of Windows will continue to support existing serial controller drivers that use the SerCx DDI.
 

In this section

TopicDescription

EVT_SERCX_APPLY_CONFIG

The EvtSerCxApplyConfig event callback function instructs the serial controller driver to apply a list of configuration settings to the serial controller hardware.

EVT_SERCX_CONTROL

The EvtSerCxControl event callback function handles an I/O control request that has an I/O control code (IOCTL) that the serial framework extension (SerCx) supports.

EVT_SERCX_FILECLEANUP

The EvtSerCxFileCleanup event callback function notifies the serial controller driver that a client has closed the last handle to the file object that represents the serial controller device.

EVT_SERCX_FILECLOSE

The EvtSerCxFileClose event callback function notifies the serial controller driver that the file object that represents the serial controller device has been released.

EVT_SERCX_FILEOPEN

The EvtSerCxFileOpen event callback function notifies the serial controller driver that a client opened a file handle on the serial controller device and that a file object has been created to represent the device.

EVT_SERCX_PURGE

The EvtSerCxPurge event callback function is called by the serial framework extension (SerCx) to purge the serial controller's hardware buffers.

EVT_SERCX_RECEIVE

The EvtSerCxReceive event callback function prepares the serial controller device (UART) to do a read (receive) operation.

EVT_SERCX_RECEIVE_CANCEL

The EvtSerCxReceiveCancel event callback function notifies the serial controller driver that the pending receive request is canceled.

EVT_SERCX_TRANSMIT

The EvtSerCxTransmit event callback function prepares the serial controller device (UART) to do a write (transmit) operation.

EVT_SERCX_TRANSMIT_CANCEL

The EvtSerCxTransmitCancel event callback function notifies the serial controller driver that the pending transmit request is canceled.

EVT_SERCX_WAITMASK

The EvtSerCxWaitmask event callback function configures the serial controller to monitor the events in a wait mask, which is a bitmask value that specifies a set of hardware events.

 

 

 

Send comments about this topic to Microsoft

Show: