Edit

Share via

MFCreateVideoSampleAllocatorEx function (mfapi.h)

  • Article

Creates an object that allocates video samples that are compatible with Microsoft DirectX Graphics Infrastructure (DXGI).

Syntax

HRESULT MFCreateVideoSampleAllocatorEx(
  [in]  REFIID riid,
  [out] void   **ppSampleAllocator
);

Parameters

[in] riid

The identifier of the interface to retrieve. Specify one of the following values.

Value Meaning
IID_IUnknown
 Retrieve an IUnknown pointer.
IID_IMFVideoSampleAllocator
 Retrieve an IMFVideoSampleAllocator pointer.
IID_IMFVideoSampleAllocatorEx
 Retrieve an IMFVideoSampleAllocatorEx pointer.
IID_IMFVideoSampleAllocatorCallback
 Retrieve an IMFVideoSampleAllocatorCallback pointer.

[out] ppSampleAllocator

Receives a pointer to the requested interface. The caller must release the interface.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This function creates an allocator for DXGI video surfaces. The buffers created by this allocator expose the IMFDXGIBuffer interface. To create an allocator for Microsoft Direct3D 9 video surfaces, call MFCreateVideoSampleAllocator.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 [desktop apps | UWP apps]
Target Platform Windows
Header mfapi.h
Library Mfplat.lib
DLL Mfplat.dll

See also

Media Foundation Functions