IMiniportAudioSignalProcessing::GetModes メソッド (portcls.h)

  • [アーティクル]

GetModes メソッドは、オーディオ ピンでサポートされているオーディオ信号処理モードを取得します。

構文

NTSTATUS GetModes(
  [in]            ULONG Pin,
  [out, optional] GUID  *SignalProcessingModes,
  [in, out]       ULONG *NumSignalProcessingModes
);

パラメーター

[in] Pin

オーディオ ピンのインデックス。

[out, optional] SignalProcessingModes

このパラメーターは省略可能です。 Pin パラメーターでサポートされている信号処理モードを識別する GUID の配列を返します。

[in, out] NumSignalProcessingModes

入力として使用する場合、 SignalProcessingModes で指定されたバッファーに書き込むことができる要素の数を指定します。 出力として使用すると、バッファーに書き込まれた要素の数が返されます。

戻り値

GetModes は、 呼び出しが成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、メソッドは適切なエラー コードを返します。

注釈

SignalProcessingModes が NULL の場合、GetModes はサポートされているモードの数を NumSignalProcessingModes に書き込み、STATUS_SUCCESSを返します。 これにより、呼び出し元は、バッファーを割り当てるために、サポートされているモードの数に対してクエリを実行できます。

SignalProcessingModes が NULL でない場合、GetModes は NumSignalProcessingModes がサポートされているモードの数以上であることを確認します。 その場合、メソッドはサポートされているモード を SignalProcessingModes バッファーに書き込み、サポートされているモードの実際の数 を NumSignalProcessingModes に書き込み、STATUS_SUCCESSを返します。

次の表では、 GetModes で返すことができるエラー メッセージを示し、説明します。

エラー コード 説明
STATUS_BUFFER_TOO_SMALL NumSignalProcessingModes 用に確保されたバッファーが小さすぎます。
STATUS_INVALID_PARAMETER Pin パラメーターの値は、>= フィルター上のピン ファクトリの数である Pin ID を示します。 ピン インデックスは 0 から始まるため、フィルター上の n 個のピン ファクトリの場合、インデックスの最大値は n-1 である必要があります。
STATUS_NOT_SUPPORTED シグナル処理モードをサポートしないピンに対して Pin ID が指定されました。 たとえば、Pin ID がオーディオ ループバック ピンまたはブリッジ ピンを参照している場合、 GetModes はこのエラー コードを返します。

要件

要件 値
サポートされている最小のクライアント Windows 8.1
サポートされている最小のサーバー Windows Server 2012 R2
対象プラットフォーム ユニバーサル
Header portcls.h

こちらもご覧ください

IMiniportAudioSignalProcessing