IAMVideoControl::GetFrameRateList-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 GetFrameRateList -Methode ruft eine Liste der verfügbaren Bildfrequenzen ab.
Syntax
HRESULT GetFrameRateList(
[in] IPin *pPin,
[in] long iIndex,
[in] SIZE Dimensions,
[out] long *ListSize,
[out] LONGLONG **FrameRates
);
Parameter
[in] pPin
Zeiger auf den Anheften, um die Liste der Bildfrequenzen abzufragen.
[in] iIndex
Index des Formats, das für die Abfrage von Bildfrequenzen verwendet werden soll. Dieser Index entspricht der Reihenfolge, in der Formate von VIDEO_STREAM_CONFIG_CAPS Strukturen aufgelistet werden, die von IAMStreamConfig::GetNumberOfCapabilities) minus 1 zurückgegeben werden.
[in] Dimensions
Framebildgröße (Breite und Höhe) in Pixel.
[out] ListSize
Zeiger auf die Anzahl der Elemente in der Liste der Bildfrequenzen.
[out] FrameRates
Adresse eines Zeigers auf ein Array von Bildfrequenzen in 100 Nanosekundeneinheiten. Kann NULL sein, wenn Sie nur ListSize benötigen.
Rückgabewert
Gibt einen HRESULT-Wert zurück, der von der Implementierung der Schnittstelle abhängt.
Hinweise
Der Aufrufer ist dafür verantwortlich, den Arbeitsspeicher über einen Aufruf von CoTaskMemFree freizugeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |