IAudioProcessingObject::IsOutputFormatSupported メソッド (audioenginebaseapo.h)

メソッドは IsOutputFormatSupported 、特定の出力形式がサポートされていることを確認するために使用されます。

構文

HRESULT IsOutputFormatSupported(
  [in, optional]  IAudioMediaType *pOppositeFormat,
  [in, optional]  IAudioMediaType *pRequestedOutputFormat,
  [out, optional] IAudioMediaType **ppSupportedOutputFormat
);

パラメーター

[in, optional] pOppositeFormat

IAudioMediaType インターフェイスへのポインター。 このパラメーターは、出力形式を示します。 出力形式が任意の型であることを示すには、このパラメーターを NULL に設定する必要があります。

[in, optional] pRequestedOutputFormat

IAudioMediaType インターフェイスへのポインター。 このパラメーターは、検証する出力形式を示します。

[out, optional] ppSupportedOutputFormat

このパラメーターは、検証する形式に最も近い、サポートされている出力形式を示します。

戻り値

呼び出しが正常に完了すると、ppSupportedOutputFormat パラメーターは pRequestedOutputFormat ポインターを返し、IsOutputFormatSupported メソッドは S_OK の値を返します。 それ以外の場合、このメソッドは次のいずれかのエラー コードを返します。

リターン コード	説明
S_FALSE	入出力形式のペアの形式はサポートされていません。 ppSupportedOutPutFormat パラメーターは、推奨される新しい形式を返します。
APOERR_FORMAT_NOT_SUPPORTED	形式はサポートされていません。 ppSupportedOutputFormat の値は変更されません。
E_POINTER	無効なポインターが関数に渡されました。 ppSupportedOutputFormat の値は変更されません。
その他の HRESULT 値	これらの追加のエラー条件は、オーディオ エンジンによって追跡されます。

注釈

メソッドの実装 IsOutputFormatSupported には、さまざまな API によって違いがあります。 たとえば、特定の実装では、入力形式が整数型の場合にのみ、出力を float 型にすることができます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム	ユニバーサル
Header	audioenginebaseapo.h
Library	Audioenginebaseapo.idl
IRQL	すべてのレベル

こちらもご覧ください

IAudioMediaType

IAudioProcessingObject