IAllocatorMXF::PutBuffer method (dmusicks.h)

This method is not currently used by the miniport driver. The PutBuffer method passes a buffer to the allocator, but this occurs automatically when IMXF::PutMessage is called anyway.

Syntax

NTSTATUS PutBuffer(
  [in] PBYTE pBuffer
);

Parameters

[in] pBuffer

Pointer to the buffer being passed to the allocator

Return value

PutBuffer returns S_OK if the call was successful. Otherwise, the method returns an appropriate error code.

Remarks

The miniport driver does not need to use this method because when the miniport driver calls IMXF::PutMessage, the allocator looks at the cbEvent member of the DMUS_KERNEL_EVENT structure to determine if uData is a pointer or just data. If cbEvent specifies that the event data is greater than the storage capacity of uData (4 bytes on a 32-bit system and 8 bytes on a 64-bit system), the allocator simply assumes that uData points to a buffer that can be reused.

Requirements

See also

DMUS_KERNEL_EVENT

IAllocatorMXF

IMXF::PutMessage