Implementieren von IMediaBuffer
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
Im DMO-Standardstreamingmodell werden Puffer über die IMediaBuffer-Schnittstelle verwaltet. Der Client des DMO ist für die Implementierung eines Objekts verantwortlich, das diese Schnittstelle verfügbar macht. Die IMediaBuffer-Schnittstelle verfügt über drei Methoden:
- GetBufferAndLength gibt die Adresse des Puffers (d. h. den tatsächlichen Speicherblock, der die Daten enthält) und die Größe aller gültigen Daten im Puffer zurück.
- GetMaxLength gibt die Größe des Puffers zurück.
- SetLength gibt die Länge der gültigen Daten im Puffer an.
Für die direkte Verarbeitung ist die IMediaBuffer-Schnittstelle nicht erforderlich. Der folgende Code zeigt eine minimale Implementierung von IMediaBuffer:
// CMediaBuffer class.
#include <dmo.h>
class CMediaBuffer : public IMediaBuffer
{
private:
DWORD m_cbLength;
const DWORD m_cbMaxLength;
LONG m_nRefCount; // Reference count
BYTE *m_pbData;
CMediaBuffer(DWORD cbMaxLength, HRESULT& hr) :
m_nRefCount(1),
m_cbMaxLength(cbMaxLength),
m_cbLength(0),
m_pbData(NULL)
{
m_pbData = new BYTE[cbMaxLength];
if (!m_pbData)
{
hr = E_OUTOFMEMORY;
}
}
~CMediaBuffer()
{
if (m_pbData)
{
delete [] m_pbData;
}
}
public:
// Function to create a new IMediaBuffer object and return
// an AddRef'd interface pointer.
static HRESULT Create(long cbMaxLen, IMediaBuffer **ppBuffer)
{
HRESULT hr = S_OK;
CMediaBuffer *pBuffer = NULL;
if (ppBuffer == NULL)
{
return E_POINTER;
}
pBuffer = new CMediaBuffer(cbMaxLen, hr);
if (pBuffer == NULL)
{
hr = E_OUTOFMEMORY;
}
if (SUCCEEDED(hr))
{
*ppBuffer = pBuffer;
(*ppBuffer)->AddRef();
}
if (pBuffer)
{
pBuffer->Release();
}
return hr;
}
// IUnknown methods.
STDMETHODIMP QueryInterface(REFIID riid, void **ppv)
{
if (ppv == NULL)
{
return E_POINTER;
}
else if (riid == IID_IMediaBuffer || riid == IID_IUnknown)
{
*ppv = static_cast<IMediaBuffer *>(this);
AddRef();
return S_OK;
}
else
{
*ppv = NULL;
return E_NOINTERFACE;
}
}
STDMETHODIMP_(ULONG) AddRef()
{
return InterlockedIncrement(&m_nRefCount);
}
STDMETHODIMP_(ULONG) Release()
{
LONG lRef = InterlockedDecrement(&m_nRefCount);
if (lRef == 0)
{
delete this;
// m_cRef is no longer valid! Return lRef.
}
return lRef;
}
// IMediaBuffer methods.
STDMETHODIMP SetLength(DWORD cbLength)
{
if (cbLength > m_cbMaxLength)
{
return E_INVALIDARG;
}
m_cbLength = cbLength;
return S_OK;
}
STDMETHODIMP GetMaxLength(DWORD *pcbMaxLength)
{
if (pcbMaxLength == NULL)
{
return E_POINTER;
}
*pcbMaxLength = m_cbMaxLength;
return S_OK;
}
STDMETHODIMP GetBufferAndLength(BYTE **ppbBuffer, DWORD *pcbLength)
{
// Either parameter can be NULL, but not both.
if (ppbBuffer == NULL && pcbLength == NULL)
{
return E_POINTER;
}
if (ppbBuffer)
{
*ppbBuffer = m_pbData;
}
if (pcbLength)
{
*pcbLength = m_cbLength;
}
return S_OK;
}
};
Zugehörige Themen