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 |
|---|---|
|
NULL-Zeigerargument |
|
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 |