CBaseAllocator-Klasse

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die CBaseAllocator-Klasse ist eine abstrakte Basisklasse, die eine Zuweisung implementiert. Allocators machen die IMemAllocator-Schnittstelle verfügbar.

Ein Zuweisungsobjekt ist ein Objekt, das Speicherpuffer zuordnet. Der Zuteilungsgeber verwaltet eine Liste der verfügbaren Puffer. Wenn ein Client (in der Regel ein Filter) einen Puffer anfordert, ruft der Zuteilungsgeber einen aus der Liste ab. Der Client füllt den Puffer mit Daten und übergibt den Puffer möglicherweise an ein anderes Objekt. Schließlich wird der Puffer freigegeben, und der Zuweisungsgeber gibt ihn in die Liste der verfügbaren Puffer zurück.

Jeder Puffer wird von einem Objekt gekapselt, das als Medienbeispiel bezeichnet wird. Medienbeispiele sind eine Möglichkeit, Zeiger auf Speicherblöcke innerhalb des COM-Frameworks (Component Object Model) zu packen. Medienbeispiele machen die IMediaSample-Schnittstelle verfügbar und werden mithilfe der CMediaSample-Klasse implementiert. Ein Medienbeispiel enthält einen Zeiger auf den zugeordneten Puffer, auf den durch Aufrufen der IMediaSample::GetPointer-Methode zugegriffen werden kann. Weitere Informationen finden Sie unter Beispiele und Zuteilungen.

Führen Sie die folgenden Schritte aus, um diese Klasse zu verwenden:

1. Rufen Sie die CBaseAllocator::SetProperties-Methode auf, um die Pufferanforderungen anzugeben, einschließlich der Anzahl der Puffer und der Größe der einzelnen Puffer.
2. Rufen Sie die CBaseAllocator::Commit-Methode auf, um die Puffer zuzuweisen.
3. Rufen Sie die CBaseAllocator::GetBuffer-Methode auf, um Medienbeispiele abzurufen. Diese Methode blockiert, bis das nächste Beispiel verfügbar wird.
4. Wenn Sie mit jedem Beispiel fertig sind, rufen Sie die IUnknown::Release-Methode für das Beispiel auf. Das Beispiel wird nicht gelöscht, wenn die Referenzanzahl 0 erreicht. Stattdessen kehrt das Beispiel zur kostenlosen Liste des Zuteilungsgebers zurück.
5. Wenn Sie mit dem Allocator fertig sind, rufen Sie die CBaseAllocator::D ecommit-Methode auf, um den Arbeitsspeicher für die Puffer freizugeben.

Die Commit-Methode ruft die virtuelle Methode CBaseAllocator::Alloc auf, die den Arbeitsspeicher für die Puffer zuordnet. Die Decommit-Methode ruft die reine virtuelle Methode CBaseAllocator::Free auf, wodurch der Arbeitsspeicher freigegeben wird. Abgeleitete Klassen müssen diese beiden Methoden außer Kraft setzen.

Die CMemAllocator-Basisklasse wird von CBaseAllocator abgeleitet. Die Filterbasisklassen verwenden die CMemAllocator-Klasse .

Geschützte Membervariablen	BESCHREIBUNG
m_lFree	Zeiger auf eine Liste der verfügbaren (kostenlosen) Medienbeispiele.
m_hSem	Semaphor, das signalisiert wird, wenn ein Beispiel verfügbar wird.
m_lWaiting	Anzahl der Threads, die auf Beispiele warten.
m_lCount	Anzahl der bereitzustellenden Puffer.
m_lAllocated	Anzahl der derzeit zugewiesenen Puffer.
m_lSize	Größe jedes Puffers.
m_lAlignment	Ausrichtung jedes Puffers.
m_lPrefix	Präfix jedes Puffers.
m_bChanged	Flag, das angibt, ob sich die Pufferanforderungen geändert haben.
m_bCommitted	Flag, das angibt, ob der Zuteilungsgeber festgelegt wurde.
m_bDecommitInProgress	Flag, das angibt, ob ein Vorgang zum Aufheben der Aussetzung ausgeführt wird.
m_pNotify	Zeiger auf eine Rückrufschnittstelle, die aufgerufen wird, wenn Beispiele freigegeben werden.
m_fEnableReleaseCallback	Flag, das angibt, ob der Releaserückruf aktiviert ist.
Geschützte Methoden	BESCHREIBUNG
Alloc	Ordnet arbeitsspeicher für die Puffer zu. Virtuellen.
Öffentliche Methoden	BESCHREIBUNG
CBaseAllocator	Konstruktormethode.
~ CBaseAllocator	Destruktormethode.
SetNotify	Veraltet.
GetFreeCount	Ruft die Anzahl der Medienbeispiele ab, die nicht verwendet werden.
NotifySample	Gibt alle Threads frei, die auf Beispiele warten.
SetWaiting	Erhöht die Anzahl der wartenden Threads.
Reine virtuelle Methoden	BESCHREIBUNG
Kostenlos	Gibt den gesamten Pufferspeicher frei.
IMemAllocator-Methoden	BESCHREIBUNG
SetProperties	Gibt die Anzahl der zuzuordnenden Puffer und die Größe der einzelnen Puffer an.
GetProperties	Ruft die Anzahl von Puffern ab, die der Zuteilungsgeber erstellt, und die Puffereigenschaften.
Commit	Ordnet den Speicher für die Puffer zu.
Aufheben der Aussetzung	Löscht die Puffer.
GetBuffer	Ruft ein Medienbeispiel ab, das einen Puffer enthält.
ReleaseBuffer	Gibt ein Medienbeispiel in die Liste der kostenlosen Medienbeispiele zurück.

Anforderungen

Anforderung	Wert
Header	Amfilter.h (include Streams.h)
Bibliothek	Strmbase.lib (Einzelhandelsbuilds); Strmbasd.lib (Debugbuilds)

Siehe auch

Bereitstellen einer benutzerdefinierten Zuordnung