IAudioClient::Start メソッド (audioclient.h)
Start メソッドは、オーディオ ストリームを開始します。
構文
HRESULT Start();
戻り値
メソッドが成功した場合は、S_OK を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。
リターン コード | 説明 |
---|---|
|
オーディオ ストリームが正常に初期化されていません。 |
|
Start 呼び出し時にオーディオ ストリームが停止されませんでした。 |
|
オーディオ ストリームはイベント ドリブン バッファリングを使用するように構成されていますが、呼び出し元は IAudioClient::SetEventHandle を呼び出してストリームにイベント ハンドルを設定していません。 |
|
オーディオ エンドポイント デバイスが取り外されているか、オーディオ ハードウェアまたは関連するハードウェア リソースが再構成、無効、削除、またはその他の方法で使用できなくなります。 |
|
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 |