IXAPO::IsOutputFormatSupported-Methode (xapo.h)

  • Artikel

Fragt ab, ob ein bestimmtes Ausgabeformat für ein bestimmtes Eingabeformat unterstützt wird.

Syntax

HRESULT IsOutputFormatSupported(
  [in]  const WAVEFORMATEX *pInputFormat,
  [in]  const WAVEFORMATEX *pRequestedOutputFormat,
  [out] WAVEFORMATEX       **ppSupportedOutputFormat
);

Parameter

[in] pInputFormat

Eingabeformat.

[in] pRequestedOutputFormat

Ausgabeformat, das überprüft werden soll, ob unterstützt wird.

[out] ppSupportedOutputFormat

Wenn nicht NULL und das Ausgabeformat für das angegebene Eingabeformat nicht unterstützt wird, gibt ppSupportedOutputFormat einen Zeiger auf das nächstgelegene Ausgabeformat zurück, das unterstützt wird. Verwenden Sie XAPOFree , um die zurückgegebene Struktur freizugeben.

Rückgabewert

Gibt S_OK zurück, wenn das Formatpaar unterstützt wird. Gibt XAPO_E_FORMAT_UNSUPPORTED zurück, wenn das Formatpaar nicht unterstützt wird.

Hinweise

Mit den Methoden IXAPO::IsInputFormatSupported und IsOutputFormatSupported kann ein XAPO angeben, welche Audioformate verarbeitet werden können. Wenn ein angefordertes Format nicht unterstützt wird, sollte das XAPO das nächstgelegene Format zurückgeben, das unterstützt wird. Das nächstgelegene Format sollte anhand der Bildfrequenz, der Bittiefe und der Kanalanzahl in dieser Reihenfolge der Wichtigkeit bestimmt werden. Das Verhalten von IsOutputFormatSupported kann sich basierend auf dem internen Zustand des XAPO ändern, aber sein Verhalten sollte zwischen Aufrufen der Methoden IXAPO::LockForProcess und IXAPO::UnlockForProcess konstant bleiben.

Plattformanforderungen

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile xapo.h

Weitere Informationen

IXAPO