IMFSampleAllocatorControl::SetDefaultAllocator メソッド (mfidl.h)

指定した出力ストリームに使用する既定のサンプルアロケーターを設定します。

構文

HRESULT SetDefaultAllocator(
  DWORD    dwOutputStreamID,
  IUnknown *pAllocator
);

dwOutputStreamID

pAllocator パラメーターが適用される出力ストリームの ID。

pAllocator

指定した出力ストリームに使用するサンプルアロケーターへのポインターを受け取ります。アロケーターは、IMFVideoCaptureSampleAllocator や IMFVideoSampleAllocatorEx などの MF アロケーターインターフェイスのいずれかをサポートします。

このメソッドは HRESULT を返します。

システムは、このメソッドを呼び出して、コンポーネントにサンプルアロケーターを提供します。これにより、コンポーネントはコンテナー内からアクセスできるメモリを使用してサンプルを割り当てることができます。

提供されたアロケーターを使用するコンポーネントは、IMFSampleAllocatorControl::GetAllocatorUsage の呼び出しからMFSampleAllocatorUsage_UsesProvidedAllocatorを返す必要があります。