IAMStreamConfig::GetFormat-Methode (strmif.h)

Artikel
03/02/2024

[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 GetFormat -Methode ruft das aktuelle oder bevorzugte Ausgabeformat ab.

Syntax

HRESULT GetFormat(
  [out] AM_MEDIA_TYPE **ppmt
);

Parameter

[out] ppmt

Adresse eines Zeigers auf eine AM_MEDIA_TYPE-Struktur .

Rückgabewert

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

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.
E_POINTER	NULL-Zeigerwert .
VFW_E_NOT_CONNECTED	Der Eingabenadel ist nicht verbunden.

Hinweise

Wenn der Pin verbunden ist, gibt diese Methode das Format zurück, das der Pin derzeit verwendet. Andernfalls gibt die Methode das bevorzugte Format der Pin für die nächste Pinverbindung zurück. Wenn Sie bereits die IAMStreamConfig::SetFormat-Methode aufgerufen haben, um das Format festzulegen, GetFormat gibt das gleiche Format zurück. Wenn dies nicht der Fall ist, wird das erste Format in der Liste der bevorzugten Formate zurückgegeben, das von der IPin::EnumMediaTypes-Methode bestimmt wird.

Die -Methode ordnet den Arbeitsspeicher für die AM_MEDIA_TYPE-Struktur zu, füllt die -Struktur aus und gibt ihn im parameter pmt zurück. Der Aufrufer muss den Arbeitsspeicher freigeben, einschließlich des Formatblocks. Sie können die DeleteMediaType-Hilfsfunktion in der Basisklassenbibliothek verwenden.

Bei einigen Komprimierungsfiltern schlägt die Methode fehl, wenn der Eingabestift des Filters nicht verbunden ist.

Beispiele

C++
IAMStreamConfig pConfig = NULL; // Query the output pin for IAMStreamConfig (not shown). AM_MEDIA_TYPE pmt = NULL; hr = pConfig->GetFormat(&pmt); if (SUCCEEDED(hr)) { /* Examine the media type for any information you need. */ DeleteMediaType(pmt); } pConfig->Release();

C++

IAMStreamConfig *pConfig = NULL;
// Query the output pin for IAMStreamConfig (not shown).
AM_MEDIA_TYPE *pmt = NULL;
hr = pConfig->GetFormat(&pmt);
if (SUCCEEDED(hr))
{
    /* Examine the media type for any information you need. */
    DeleteMediaType(pmt);
}
pConfig->Release();

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

Weitere Informationen

Fehler- und Erfolgscodes

IAMStreamConfig-Schnittstelle

Freigeben über