IMFCaptureSource::GetAvailableDeviceMediaType-Methode (mfcaptureengine.h)

Artikel
03/01/2024

Ruft ein Format ab, das von einem der Aufnahmedatenströme unterstützt wird.

Syntax

HRESULT GetAvailableDeviceMediaType(
  [in] DWORD        dwSourceStreamIndex,
  [in] DWORD        dwMediaTypeIndex,
  [in] IMFMediaType **ppMediaType
);

Parameter

[in] dwSourceStreamIndex

Der abzufragende Stream. Der Wert kann einer der folgenden Werte sein.

Wert	Bedeutung
0–0xFFFFFFFB	Der nullbasierte Index eines Datenstroms. Rufen Sie ZUM Abrufen der Anzahl der Streams IMFCaptureSource::GetDeviceStreamCount auf.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM 0xFFFFFFFB	Der erste Bilddatenstrom.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM 0xFFFFFFFC	Der erste Videostream.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM 0xFFFFFFFD	Der erste Audiodatenstrom.

[in] dwMediaTypeIndex

Der nullbasierte Index des abzurufenden Medientyps.

[in] ppMediaType

Empfängt einen Zeiger auf die IMFMediaType-Schnittstelle . Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
MF_E_INVALIDSTREAMNUMBER	Der dwSourceStreamIndex-Parameter ist ungültig.
MF_E_NO_MORE_TYPES	Der dwMediaTypeIndex-Parameter liegt außerhalb des Bereichs.

Hinweise

Um alle verfügbaren Formate in einem Stream aufzulisten, rufen Sie diese Methode in einer Schleife auf, während dwMediaTypeIndex erhöht wird, bis die Methode MF_E_NO_MORE_TYPES zurückgibt.

Einige Kameras unterstützen möglicherweise einen Bereich von Bildfrequenzen. Die minimale und die maximale Bildfrequenz werden in den Attributen MF_MT_FRAME_RATE_RANGE_MIN und MF_MT_FRAME_RATE_RANGE_MAX für den Medientyp gespeichert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mfcaptureengine.h

Weitere Informationen

IMFCaptureSource

Freigeben über