IDvdInfo2::GetState
GetState メソッドは、ディスク位置と DVD ナビゲータ状態情報が格納されているブックマークを取得する。
構文
HRESULT GetState(
IDvdState **pStateData
);
パラメータ
pStateData
[out] DVD ナビゲータによって割り当てられた DvdState オブジェクトの IDvdState インターフェイスへのポインタのアドレス。
戻り値
次のいずれかの HRESULT 値を返す。
戻りコード | 説明 |
S_OK | 成功。 |
E_INVALIDARG | 無効な引数。 |
E_UNEXPECTED | DVD ナビゲータが初期化されていない。 |
注意
このメソッドが呼び出されると、DVD ナビゲータは新しい状態オブジェクトを作成し、そのオブジェクトに現在の位置、現在のペアレンタル レベル、その他の状態情報を保存する。後から DVDState オブジェクトを使って IDvdControl2::SetState を呼び出すことにより、保存した位置に DVD ナビゲータを戻すことができる。これにより、利用者は、ディスクの途中で再生を停止してその位置を保存し、後から、すべての内部設定を元どおりに復元して、前に停止した位置から再生を再開できる。
DVD ナビゲータは、DvdState オブジェクトをアプリケーションに返す前に、DvdState オブジェクトに対する AddRef を呼び出す。アプリケーションは、オブジェクトを使った後、オブジェクトに対する Release を呼び出す必要がある。
このメソッドの使用例については、DVDSample アプリケーションの「CDvdCore::RestoreBookmark」を参照すること。
参照