次の方法で共有

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 信号処理モードをサポートしていないピンにピン ID が指定されました。 たとえば、Pin ID がオーディオ ループバック ピンまたはブリッジ ピンを参照している場合、GetModes は、このエラー コードを返します。

必要条件

要件 価値
サポートされる最小クライアント Windows 8.1
サポートされる最小サーバー Windows Server 2012 R2
ターゲット プラットフォーム の 万国
ヘッダー portcls.h

関連項目

IMiniportAudioSignalProcessing の