IAMStreamConfig::GetFormat-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 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.

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

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

Weitere Informationen

Fehler- und Erfolgscodes

IAMStreamConfig-Schnittstelle