次の方法で共有

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

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

構文

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

パラメーター

pRequestedInputFormat

検証する入力形式。

ppSupportedInputFormat

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

戻り値

HRESULT

HRESULT Description
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 が処理のためにロックされると、この形式は変更できず、変更されません。

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

Requirements

Requirement 価値
サポートされる最小クライアント Windows 10 ビルド 20348
Header audioenginebaseapo.h
  • Last updated on