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 DlReady field is part of the link layer extensions and is documented in the link layer API manual.