MFCreateVideoSampleAllocatorEx function

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

Syntax

C++


HRESULT MFCreateVideoSampleAllocatorEx(
  _In_  REFIID riid,
  _Out_ void** ppSampleAllocator
);

Parameters

riid [in]

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.

ppSampleAllocator [out]

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

Minimum supported client	Windows 8 [desktop apps \| Windows Store apps]
Minimum supported server	Windows Server 2012 [desktop apps \| Windows Store apps]
Minimum supported phone	Windows Phone 8.1
Header	Mfapi.h
Library	Mfplat.lib
DLL	Mfplat.dll