IMemAllocatorCallbackTemp::GetFreeCount-Methode (strmif.h)

[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.]

Die GetFreeCount -Methode gibt die Anzahl der kostenlosen Medienbeispiele zurück. Diese Zahl entspricht der Gesamtzahl der Medienbeispiele abzüglich der Anzahl der Stichproben, die derzeit von Filtern gehalten werden.

Syntax

HRESULT GetFreeCount(
  [out] LONG *plBuffersFree
);

Parameter

[out] plBuffersFree

Zeiger auf eine Variable, die die Anzahl der kostenlosen Medienbeispiele empfängt.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode	Beschreibung
E_POINTER	NULL-Zeigerargument
S_OK	Erfolg

Bemerkungen

Ein Filter enthält ein Beispiel, indem er eine Referenzanzahl für dieses zählt. Das Beispiel wird freigegeben, indem die Verweisanzahl freigegeben wird.

Bis zum Commit für die Zuweisung wird nicht garantiert, dass die Stichproben zugeordnet werden.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Siehe auch

Fehler- und Erfolgscodes

IMemAllocatorCallbackTemp-Schnittstelle