Edit

MFSampleAllocatorUsage enumeration (mfidl.h)

  • Article

Specifies the allocator usage of components that implement the IMFSampleAllocatorControl interface.

Syntax

typedef enum MFSampleAllocatorUsage {
  MFSampleAllocatorUsage_UsesProvidedAllocator = 0,
  MFSampleAllocatorUsage_UsesCustomAllocator,
  MFSampleAllocatorUsage_DoesNotAllocate
} ;

Constants

 
MFSampleAllocatorUsage_UsesProvidedAllocator
Value: 0
The output stream will use the camera pipeline's sample allocator to allocate new media samples. If the output stream is producing samples in CPU memory, it is recommended that it use this mode to ensure consistent performance when used in a cross-container scenario.
MFSampleAllocatorUsage_UsesCustomAllocator
The output stream will be use a custom allocator for its output samples. It will not use the sample allocator provided by the camera pipeline.
MFSampleAllocatorUsage_DoesNotAllocate
The output stream will not allocate new samples for its output samples. It will not be provided a sample allocator by the camera pipeline.

Remarks

Components should pass a value from the enumeration back from an implementation of IMFSampleAllocatorControl::GetAllocatorUsage to let the system know if they will use the system-provided allocator.

Requirements

Requirement Value
Minimum supported client Windows 10, version 2004 (10.0; Build 19041)
Minimum supported server Windows Server, version 2004 (10.0; Build 19041)
Header mfidl.h