Jump to main content

##

# 1.1.9.4.17 DRV_USART_BUFFER_HANDLE Typedef

## C

    typedef uintptr_t DRV_USART_BUFFER_HANDLE;

## Summary

Handle identifying a read or write buffer passed to the driver.

## Description

A buffer handle value is returned by a call to the DRV_USART_ReadBufferAdd or DRV_USART_WriteBufferAdd functions. This handle is associated with the buffer passed into the function and it allows the application to track the completion of the data from (or into) that buffer. The buffer handle value returned from the "buffer add" function is returned back to the client by the "event handler callback" function registered with the driver.

The buffer handle assigned to a client request expires when the client has been notified of the completion of the buffer transfer (after event handler function that notifies the client returns) or after the buffer has been retired by the driver if no event handler callback was set.

## Remarks

None