SoundAddIrpToCancellableQ

VOID
    SoundAddIrpToCancellableQ(
        PLIST_ENTRY QueueHead,
        PIRP Irp,
        BOOLEAN Head
        );

The SoundAddIrpToCancellableQ function adds an IRP to a queue and makes the IRP cancelable.

Parameters

QueueHead

Pointer to the head of a queue of IRPs.

Irp

Pointer to an IRP.

Head

TRUE or FALSE. If TRUE, add IRP to head of queue. If FALSE, add IRP to tail of queue.

Return Value

None.

Comments

Before an IRP can be added to the queue, the queue must be initialized by calling InitializeListHead.

Generally, drivers using soundlib.lib do not need to manipulate IRP queues because DPCs in soundlib.lib handle IRP completion. For drivers that do manipulate IRP queues, the SoundAddIrpToCancellableQ, SoundRemoveFromCancellableQ, SoundMoveCancellableQueue, SoundFreePendingIrps, and SoundFreeQ functions are provided.