IAudioClient::Reset メソッド (audioclient.h)

  • [アーティクル]

Reset メソッドは、オーディオ ストリームをリセットします。

構文

HRESULT Reset();

戻り値

メソッドが成功した場合は、S_OK を返します。 メソッドが成功し、ストリームが既にリセットされている場合、メソッドは S_FALSEを返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。

リターン コード 説明
AUDCLNT_E_NOT_INITIALIZED
 オーディオ ストリームが正常に初期化されていません。
AUDCLNT_E_NOT_STOPPED
 呼び出しが行われた時点で、オーディオ ストリームが停止されませんでした。
AUDCLNT_E_BUFFER_OPERATION_PENDING
 クライアントは現在、バッファーへの書き込み中またはバッファーからの読み取り中です。
AUDCLNT_E_SERVICE_NOT_RUNNING
 Windows オーディオ サービスが実行されていません。

注釈

このメソッドでは、 IAudioClient インターフェイスを事前に初期化する必要があります。 クライアントが IAudioClient::Initialize メソッドを正常に呼び出してオーディオ ストリームを初期化するまで、このメソッドの呼び出しはすべてエラー AUDCLNT_E_NOT_INITIALIZEDで失敗します。

Reset は、停止したオーディオ ストリームをリセットするためにクライアントが呼び出すコントロール メソッドです。 ストリームをリセットすると、保留中のすべてのデータがフラッシュされ、オーディオ クロック ストリームの位置が 0 にリセットされます。 このメソッドは、停止されていないストリームで呼び出されると失敗します。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー audioclient.h

こちらもご覧ください

IAudioClient インターフェイス

IAudioClient::Initialize