IAMVideoControl::GetMaxAvailableFrameRate-Methode (strmif.h)

Artikel
07/28/2023

[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 GetMaxAvailableFrameRate -Methode ruft die maximale derzeit verfügbare Framerate ab, basierend auf der Busbandbreitennutzung für Verbindungen wie USB und IEEE 1394, wobei die maximale Bildfrequenz durch die Bandbreitenverfügbarkeit begrenzt werden kann.

Syntax

HRESULT GetMaxAvailableFrameRate(
  [in]  IPin     *pPin,
  [in]  long     iIndex,
  [in]  SIZE     Dimensions,
  [out] LONGLONG *MaxAvailableFrameRate
);

Parameter

[in] pPin

Zeiger auf den Pin, aus dem die maximale Bildfrequenz abgerufen werden soll.

[in] iIndex

Index des Abzufragenden Formats für die maximale Bildfrequenz. Dieser Index entspricht der Reihenfolge, in der Formate von IAMStreamConfig::GetStreamCaps aufgezählt werden. Der Wert muss zwischen null und der Anzahl der unterstützten VIDEO_STREAM_CONFIG_CAPS Strukturen liegen, die von IAMStreamConfig::GetNumberOfCapabilities) minus 1 zurückgegeben werden.

[in] Dimensions

Framebildgröße (Breite und Höhe) in Pixel.

[out] MaxAvailableFrameRate

Zeiger auf die maximal verfügbare Bildfrequenz. Die Bildfrequenz wird als Framedauer in Einheiten von 100 Nanosekunden ausgedrückt.

Rückgabewert

Gibt einen HRESULT-Wert zurück, der von der Implementierung der Schnittstelle abhängt.

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

IAMVideoControl-Schnittstelle

VIDEO_STREAM_CONFIG_CAPS-Struktur

Freigeben über