Microsoft DirectX 8.0 (Visual Basic) |
object.Stop()
失敗した場合はエラーが発生し、Err.Number に次のいずれかのエラー値が設定される。
DSERR_INVALIDPARAM |
DSERR_PRIOLEVELNEEDED |
アプリケーションが DSSCL_WRITEPRIMARY レベルに設定されている場合、このメソッドはプライマリ バッファを停止し、再生カーソルをバッファの先頭に設定する。これは、多くのサウンド カードのプライマリ バッファが、バッファの先頭からしか再生できないためである。
ただし、プライマリ バッファで DirectSoundPrimaryBuffer8.Stop を呼び出し、アプリケーションの協調レベルが DSSCL_WRITEPRIMARY 以外である場合、このメソッドは DirectSoundPrimaryBuffer8.Play と逆の効果を与えるだけである。セカンダリ バッファが再生されていない場合は、プライマリ バッファを停止するように構成する。同じアプリケーションまたは別のアプリケーションでほかのバッファが再生されている場合、それらのバッファが停止されるまで、プライマリ バッファも実際には停止されない。振幅が 0 dB であっても、バッファがサウンド データを再生している場合は処理のオーバーヘッドが発生するので、このメソッドを使ってプライマリ バッファを停止することは役に立つ。