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

  • [アーティクル]

Start メソッドは、オーディオ ストリームを開始します。

構文

HRESULT Start();

戻り値

メソッドが成功した場合は、S_OK を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。

リターン コード 説明
AUDCLNT_E_NOT_INITIALIZED
 オーディオ ストリームが正常に初期化されていません。
AUDCLNT_E_NOT_STOPPED
 Start 呼び出し時にオーディオ ストリームが停止されませんでした。
AUDCLNT_E_EVENTHANDLE_NOT_SET
 オーディオ ストリームはイベント ドリブン バッファリングを使用するように構成されていますが、呼び出し元は IAudioClient::SetEventHandle を呼び出してストリームにイベント ハンドルを設定していません。
AUDCLNT_E_DEVICE_INVALIDATED
 オーディオ エンドポイント デバイスが取り外されているか、オーディオ ハードウェアまたは関連するハードウェア リソースが再構成、無効、削除、またはその他の方法で使用できなくなります。
AUDCLNT_E_SERVICE_NOT_RUNNING
 Windows オーディオ サービスが実行されていません。

注釈

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

Start は、クライアントがオーディオ ストリームを開始するために呼び出すコントロール メソッドです。 ストリームを開始すると、 IAudioClient オブジェクトがエンドポイント バッファーとオーディオ エンジンの間でデータのストリーミングを開始します。 また、ストリームのオーディオ クロックが現在の位置からカウントを再開します。

ストリームの初期化後にこのメソッドが初めて呼び出されると、 IAudioClient オブジェクトのストリーム位置カウンターは 0 から始まります。 それ以外の場合、ストリームが最後に停止した時点で、クロックはその位置から再開されます。 ストリームをリセットすると、ストリームの位置が強制的に 0 に戻ります。

レンダリング ストリームの起動の不具合を回避するために、レンダリング インターフェイスで IAudioRenderClient::GetBuffer メソッドと IAudioRenderClient::ReleaseBuffer メソッドを呼び出して、オーディオ エンジンにデータが最初に読み込まれるまで、クライアントは Start を呼び出さないでください。

Start メソッドを呼び出すコード例については、次のトピックを参照してください。

要件

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

こちらもご覧ください

IAudioClient インターフェイス

IAudioClient::Initialize

IAudioRenderClient::GetBuffer

IAudioRenderClient::ReleaseBuffer