IApoAuxiliaryInputConfiguration::IsInputFormatSupported メソッド (audioenginebaseapo.h)

  • [アーティクル]

APO で特定の補助入力形式がサポートされていることを確認します。

構文

HRESULT IsInputFormatSupported(
  IAudioMediaType *pRequestedInputFormat,
  IAudioMediaType **ppSupportedInputFormat
);

パラメーター

pRequestedInputFormat

検証する入力形式。

ppSupportedInputFormat

APO は、このパラメーターに、メソッドに渡される形式に最も近いサポートされている入力形式を設定します。

戻り値

HRESULT

HRESULT 説明
S_OK 正常に完了しました。 APO は pRequestedInputFormat への参照を追加し、ppSupportedInputFormat で返す必要があります
S_FALSE 形式はサポートされていません。 APO は、サポートされている推奨される形式を ppSupportedInputFormat で返す必要があります
APOERR_FORMAT_NOT_SUPPORTED 形式はサポートされていません。 APO は ppSupportedInputFormat を変更しないでください
E_POINTER この関数に渡されたポインターが無効です。
その他の値 別のコンポーネントによってエラーが発生しています。 これらの障害はシステムによって追跡されます。

注釈

APO が要求された形式を受け入れられる場合は、要求された形式への参照を追加し、これをサポートされている出力形式として返し、S_OKを返す必要があります。

APO が要求された形式を受け入れられない場合は、別の要求された形式が提案される可能性があります。 この場合は、提案された形式を作成して返し、S_FALSEを返す必要があります。

返されるサポートされる形式は、要求された形式に最も近い形式にする必要があります。つまり、形式は、優先順位で指定された次のプロパティに対して同じ値を持つ必要があります。

  • サンプル形式
  • ビット深度
  • チャネルの数
  • サンプル レート

提案された形式は、S_FALSEが返された場合にのみ、要求された形式と異なる場合があります。 エラーが返された場合は、推奨される形式をそのままにしておく必要があります。

この API は、いつでも呼び出されます。 返される結果は、外部ユーザー インターフェイスによって操作される可能性がある APO の内部状態によって異なります。 ただし、APO が処理のためにロックされると、この形式は変更できず、変更されません。

このメソッドは、リアルタイム処理スレッドから呼び出されない場合があります。

要件

要件 値
サポートされている最小のクライアント Windows 10 ビルド 20348
Header audioenginebaseapo.h