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
標頭 audioenginebaseapo.h