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

EvtSerCxApplyConfig

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

EvtSerCxControl

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.

EvtSerCxFileCleanup

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.

EvtSerCxFileClose

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

EvtSerCxFileOpen

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.

EvtSerCxPurge

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

EvtSerCxReceive

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

EvtSerCxReceiveCancel

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

EvtSerCxTransmit

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

EvtSerCxTransmitCancel

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

EvtSerCxWaitmask

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:
© 2015 Microsoft