IDvdInfo2::GetState メソッド (strmif.h)

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

メソッドは GetState 、ディスクの場所と DVD ナビゲーターの状態情報を含むブックマークを取得します。

構文

HRESULT GetState(
  [out] IDvdState **pStateData
);

パラメーター

[out] pStateData

DVD ナビゲーターによって割り当てられた DvdState オブジェクトの IDvdState インターフェイスへのポインターを受け取ります。

戻り値

次のいずれかの HRESULT 値を 返します。

解説

このメソッドが呼び出されると、DVD ナビゲーターによって新しい状態オブジェクトが作成され、現在の場所だけでなく、現在の親レベルやその他の状態情報も保存されます。 DVDState オブジェクトを使用すると、後で IDvdControl2::SetState を呼び出して、保存された場所に DVD ナビゲーターを復元できます。 これにより、視聴者はディスクの中央で表示を停止し、場所を保存し、後で戻って中断した場所を表示し始め、すべての内部設定が以前と同じように復元されます。

DVD ナビゲーターは、アプリケーションに返す前に、DvdState オブジェクトの AddRef を呼び出します。 アプリケーションは、オブジェクトの終了時に Release を呼び出す必要があります。

このメソッドは、 CDvdCore::RestoreBookmark の DVDSample アプリケーションで示されています。

要件

関連項目

DVD アプリケーション

エラーコードと成功コード

IDvdInfo2 インターフェイス