IAllocatorMXF::GetBuffer method (dmusicks.h)

The GetBuffer method allocates a buffer for long MIDI events.

Syntax

NTSTATUS GetBuffer(
  [out] PBYTE *ppBuffer
);

Parameters

[out] ppBuffer

Output pointer for the buffer. This parameter points to a caller-allocated pointer variable into which the method writes a pointer to the buffer.

Return value

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

Remarks

The miniport driver calls this method only when it needs to send large chunks of data to the capture sink. Specifically, the miniport driver uses this method whenever a component needs to package more data than can be stored in the uData member of DMUS_KERNEL_EVENT.

The size of the buffer can determined by calling IAllocatorMXF::GetBufferSize. GetBufferSize needs to be called only once because the buffer size is constant for any allocator implementation.

Requirements

Requirement Value
Target Platform Desktop
Header dmusicks.h (include Dmusicks.h)
IRQL <=DISPATCH_LEVEL

See also

DMUS_KERNEL_EVENT

IAllocatorMXF

IAllocatorMXF::GetBufferSize