Driver Interface Callbacks

The driver interface callbacks are entry points into a driver that is a client of the HDLC API. These callbacks allow the API to inform the client driver when certain events occur. Callbacks are specified in a DICALLBACKS structure passed to DiMgslOpen. Some callbacks are optional and may be set to NULL.

The first argument to all callbacks is the client specified Context field of the DICALLBACKS structure. This context is usually a pointer to the client device instance data (device extension).

typedef struct _DICALLBACKS
{
    void *Context;
    void (*TransmitComplete)(void *Context, ULONG status);
    void (*ReceiveReady)(void *Context);
    void (*EventReady)(void *Context, ULONG Events);
    void (*TraceReady)(void *Context);
    void (*DlReady)(void *Context);

} DICALLBACKS, *PDICALLBACKS;

The TransmitComplete, ReceiveReady, EventReady, and TraceReady callbacks are described in the Base API manual.