IAllocatorMXF::GetBuffer method

The GetBuffer method allocates a buffer for long MIDI events.

Syntax


NTSTATUS GetBuffer(
  [out]  PBYTE *ppbBuffer
);

Parameters

ppbBuffer [out]

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

Header

Dmusicks.h (include Dmusicks.h)

IRQL

<=DISPATCH_LEVEL

See also

DMUS_KERNEL_EVENT
IAllocatorMXF::GetBufferSize

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft