Platform SDK: DirectX

DirectSound.SetCooperativeLevel

DirectSound.SetCooperativeLevel メソッドは、このサウンド デバイスのアプリケーション協調レベルを設定する。

object.SetCooperativeLevel(hwnd As Long, _
    level As CONST_DSSCLFLAGS)

パラメータ

object
DirectSound オブジェクトを表すオブジェクト式。
hwnd
アプリケーションへのウィンドウ ハンドル。「注意」を参照すること。
level
要求される優先レベル。CONST_DSSCLFLAGS 列挙の定数でなければならない。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかのエラー コードが設定される。

DSERR_ALLOCATED
DSERR_INVALIDPARAM
DSERR_UNINITIALIZED
DSERR_UNSUPPORTED

注意

アプリケーションはバッファを再生する前に、このメソッドを呼び出して協調レベルを設定しなければならない。推奨される協調レベルは DSSCL_PRIORITY であり、他の優先レベルは必要に応じて使用する。

hwnd パラメータは、最上位のアプリケーション ウィンドウ ハンドルとすべきである。DirectDraw も使っている場合は、DirectDraw7.SetCooperativeLevel メソッドに渡したのと同じハンドルを指定しなければならない。