IAudioClient::Reset メソッド (audioclient.h)
Reset メソッドは、オーディオ ストリームをリセットします。
構文
HRESULT Reset();
戻り値
メソッドが成功した場合は、S_OK を返します。 メソッドが成功し、ストリームが既にリセットされている場合、メソッドは S_FALSEを返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。
| リターン コード | 説明 |
|---|---|
|
オーディオ ストリームが正常に初期化されていません。 |
|
呼び出しが行われた時点で、オーディオ ストリームが停止されませんでした。 |
|
クライアントは現在、バッファーへの書き込み中またはバッファーからの読み取り中です。 |
|
Windows オーディオ サービスが実行されていません。 |
注釈
このメソッドでは、 IAudioClient インターフェイスを事前に初期化する必要があります。 クライアントが IAudioClient::Initialize メソッドを正常に呼び出してオーディオ ストリームを初期化するまで、このメソッドの呼び出しはすべてエラー AUDCLNT_E_NOT_INITIALIZEDで失敗します。
Reset は、停止したオーディオ ストリームをリセットするためにクライアントが呼び出すコントロール メソッドです。 ストリームをリセットすると、保留中のすべてのデータがフラッシュされ、オーディオ クロック ストリームの位置が 0 にリセットされます。 このメソッドは、停止されていないストリームで呼び出されると失敗します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | audioclient.h |