Microsoft DirectX 8.0

IDvdState インターフェイス

IDvdState インターフェイスは、DvdState オブジェクトによって実装される。DvdState オブジェクトは、アプリケーションが IDvdInfo2::GetState を呼び出して、再生位置、ペアレンタル ロック レベル、リージョンを含むユーザーのセッションの状態をディスクに保存するときに、DVD ナビゲータ フィルタによって作成される。アプリケーションは、IDvdState メソッドを使用して、DvdState オブジェクトに保存されるこの情報を問い合わせることができる。

DvdState オブジェクトは、IPersist を実装して、ディスクへの保存を有効にする。ブックマークを保存する方法を示すサンプル コードについては、「DvdState オブジェクトの保存と復元」を参照すること。

DVD ナビゲータは、DVD 上の現在の再生位置、ユーザーのペアレンタル ロック レベル、および DVD リージョンによって DvdState オブジェクトを初期化する。この方法の代わりに、アプリケーションが CoCreateInstance: を呼び出すことによって状態オブジェクトを作成することもできる。

CoCreateInstance( CLSID_DVDState, NULL, CLSCTX_INPROC_SERVER, 
    IID_IDvdState, (void **) ppState );

後から、ペアレンタル ロック レベルとリージョンの設定を復元し、GetState が呼び出されたときに停止した位置から再生を再開するには、IDvdControl2::SetState を呼び出す。

vtable 順のメソッド

IUnknown メソッド説明
QueryInterface サポートされているインターフェイスへのポインタを取得する。
AddRef 参照カウントをインクリメントする。
Release 参照カウントをデクリメントする。
IDvdState メソッド説明
GetDiscID ブックマークが作成されたディスクの一意な識別子 (ID) を取得する。
GetParentalLevel DvdState オブジェクトに保存されたユーザーのペアレンタル ロック レベルを取得する。
GetRegion DvdState オブジェクトに保存された DVD リージョンを取得する。

IDvdState::GetDiscID

IDvdState インターフェイス

ブックマークが作成されたディスクの一意な識別子 (ID) を取得する。

構文

HRESULT GetDiscID(
  ULONGLONG *pullUniqueID
  );

パラメータ

pullUniqueID
[out] ID を受け取る ULONGLONG 型の変数へのポインタ。

戻り値

次の表に示されるいずれかの値を返す。

S_OK 成功。
E_POINTER無効な引数。

IDvdState::GetParentalLevel

IDvdState インターフェイス

DvdDState オブジェクトに保存されたユーザーのペアレンタル ロック レベルを取得する。

構文

HRESULT GetParentalLevel(
  ULONG *pulParentalLevel
  );

パラメータ

pulParentalLevel
[out] ペアレンタル ロック レベルを受け取る ULONG 型の変数へのポインタ。

戻り値

次のいずれかの値を返す。
S_OK成功。
E_POINTER無効な引数。

IDvdState::GetRegion

IDvdState インターフェイス

DvdState オブジェクトに保存された DVD リージョンを取得する。

構文

HRESULT GetRegion(
  ULONG *pulRegion
  );

パラメータ

pulRegion
[out] リージョン値を受け取る ULONG 型の変数へのポインタ。

戻り値

次のいずれかの値を返す。
S_OK 成功。
E_UNEXPECTEDDVD ナビゲータが初期化されていない。
E_POINTER無効な引数。