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 ナビゲーターが初期化されていません。 |
解説
このメソッドが呼び出されると、DVD ナビゲーターによって新しい状態オブジェクトが作成され、現在の場所だけでなく、現在の親レベルやその他の状態情報も保存されます。 DVDState オブジェクトを使用すると、後で IDvdControl2::SetState を呼び出して、保存された場所に DVD ナビゲーターを復元できます。 これにより、視聴者はディスクの中央で表示を停止し、場所を保存し、後で戻って中断した場所を表示し始め、すべての内部設定が以前と同じように復元されます。
DVD ナビゲーターは、アプリケーションに返す前に、DvdState オブジェクトの AddRef を呼び出します。 アプリケーションは、オブジェクトの終了時に Release を呼び出す必要があります。
このメソッドは、 CDvdCore::RestoreBookmark の DVDSample アプリケーションで示されています。
要件
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | strmif.h (Dshow.h を含む) |
| Library | Strmiids.lib |