SerCx Driver Support Methods

This section describes the driver support methods that are defined by version 1 of the serial framework extension (SerCx). These methods are implemented by the SerCx runtime module, Sercx.sys. Your serial controller driver calls these methods to communicate with SerCx. All SerCx DDI methods that can return status codes return NTSTATUS values. The methods 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

SerCxCompleteWait

The SerCxCompleteWait method notifies the serial framework extension (SerCx) that an event in the current wait mask has occurred.

SerCxDeviceInitConfig

The SerCxDeviceInitConfig method is called by the serial controller driver to attach the serial framework extension (SerCx) to the I/O pipeline for a framework device object (FDO or PDO) that it is creating.

SerCxGetActivity

The SerCxGetActivity method retrieves the status of pending work for the serial controller driver.

SerCxGetConnectionParameters

The SerCxGetConnectionParameters method retrieves the connection parameters for the associated peripheral device.

SerCxGetReadIntervalTimeout

The SerCxGetReadIntervalTimeout method returns the interval time-out value for a read (receive) operation.

SerCxGetRingBufferUtilization

The SerCxGetRingBufferUtilization method enables the serial controller driver to determine how much of the type-ahead ring buffer is currently filled by data received from the serial port.

SerCxGetWaitMask

The SerCxGetWaitMask method returns the event wait mask for the wait operation that is currently pending.

SerCxInitialize

The SerCxInitialize method completes the initialization of the serial framework extension (SerCx) after this driver creates the associated device object.

SerCxProgressReceive

The SerCxProgressReceive method reports the progress of the current read (receive) operation.

SerCxProgressTransmit

The SerCxProgressTransmit method reports the progress of the current write (transmit) operation.

SerCxRetrieveReceiveBuffer

The SerCxRetrieveReceiveBuffer method obtains an input buffer into which data received from the serial port can be loaded.

SerCxRetrieveTransmitBuffer

The SerCxRetrieveTransmitBuffer method obtains an output buffer that contains data that is ready to be transmitted to the serial port.

SerCxRetrieveReceiveMdl

The SerCxRetrieveReceiveMdl method retrieves the MDL that describes the buffer to use to receive the next block of input data.

SerCxRetrieveTransmitMdl

The SerCxRetrieveTransmitMdl method retrieves the MDL that describes the buffer that contains the next block of output data to be transmitted.

 

 

 

Send comments about this topic to Microsoft

Mostra:
© 2014 Microsoft