Microsoft DirectX 8.0 (Visual Basic)

DirectSoundPrimaryBuffer8.Stop

サウンド バッファの再生を停止する。

object.Stop()

指定項目

object
DirectSoundPrimaryBuffer8 オブジェクトを指定する。

エラー コード

失敗した場合はエラーが発生し、Err.Number に次のいずれかのエラー値が設定される。

DSERR_INVALIDPARAM
DSERR_PRIOLEVELNEEDED

注意

アプリケーションが DSSCL_WRITEPRIMARY レベルに設定されている場合、このメソッドはプライマリ バッファを停止し、再生カーソルをバッファの先頭に設定する。これは、多くのサウンド カードのプライマリ バッファが、バッファの先頭からしか再生できないためである。

ただし、プライマリ バッファで DirectSoundPrimaryBuffer8.Stop を呼び出し、アプリケーションの協調レベルが DSSCL_WRITEPRIMARY 以外である場合、このメソッドは DirectSoundPrimaryBuffer8.Play と逆の効果を与えるだけである。セカンダリ バッファが再生されていない場合は、プライマリ バッファを停止するように構成する。同じアプリケーションまたは別のアプリケーションでほかのバッファが再生されている場合、それらのバッファが停止されるまで、プライマリ バッファも実際には停止されない。振幅が 0 dB であっても、バッファがサウンド データを再生している場合は処理のオーバーヘッドが発生するので、このメソッドを使ってプライマリ バッファを停止することは役に立つ。