Microsoft DirectX 8.0

IXml2Dex インターフェイス

Microsoft® DirectShow® 編集サービス (DES) の、拡張可能マークアップ言語 (XML) で記述されたプロジェクト ファイルの保存とロードを行う。このインターフェイスは、DirectShow グラフ (.grf) ファイルの読み込みと書き込みを行うメソッドも提供する。

要件

Qedit.h を必要とする。

Internet Explorer 4.0 以降を必要とする。

vtable 順のメソッド

IUnknown メソッド説明
QueryInterfaceサポートされているインターフェイスへのポインタを取得する。
AddRef参照カウントをインクリメントする。
Release参照カウントをデクリメントする。
IXml2Dex メソッド説明
CreateGraphFromFile実装されていない。
WriteGrfFileフィルタ グラフを .grf フォーマットでファイルに書き込む。
WriteXMLFileタイムラインを XML に変換し、XML データをファイルに書き込む。
ReadXMLFileXML プロジェクト ファイルをロードする。
Delete実装されていない。
WriteXMLPart実装されていない。
PasteXMLFile実装されていない。
CopyXML実装されていない。
PasteXML実装されていない。
Reset実装されていない。
ReadXML実装されていない。
WriteXMLタイムラインを XML 文字列に変換する。

IXml2Dex::CopyXML

IXml2Dex インターフェイス

実装されていない。

構文

HRESULT CopyXML(
    IUnknown *pTimeline,
    double dStart,
    double dEnd
);

IXml2Dex::CreateGraphFromFile

IXml2Dex インターフェイス

実装されていない。

構文

HRESULT CreateGraphFromFile(
    IUnknown **ppGraph,
    IUnknown *pTimeline,
    BSTR FileName
);

IXml2Dex::Delete

IXml2Dex インターフェイス

実装されていない。

構文

HRESULT Delete(
    IUnknown *pTimeline,
    double dStart,
    double dEnd
);

IXml2Dex::PasteXML

IXml2Dex インターフェイス

実装されていない。

構文

HRESULT PasteXML(
    IUnknown *pTimeline,
    double dStart
);

IXml2Dex::PasteXMLFile

IXml2Dex インターフェイス

実装されていない。

構文

HRESULT PasteXMLFile(
    IUnknown *pTimeline,
    double dStart,
    BSTR FileName
);

IXml2Dex::ReadXML

IXml2Dex インターフェイス

実装されていない。

構文

HRESULT ReadXML(
    IUnknown *pTimeline,
    IUnknown *pXML
);

IXml2Dex::ReadXMLFile

IXml2Dex インターフェイス

XML プロジェクト ファイルをロードする。このメソッドは、XML ファイルで表現されているすべてのオブジェクトのインスタンスを作成してタイムラインに挿入し、フレーム レートやデフォルト エフェクトなどの所定の属性をタイムラインに適用する。

構文

HRESULT ReadXMLFile(
    IUnknown *pTimeline,
    BSTR XMLName
);

パラメータ

pTimeline
タイムライン オブジェクトの IUnknown インターフェイスへのポインタ。
XMLName
ロードするファイルの名前を指定する文字列。

戻り値

成功した場合は、S_OK を返す。そうでない場合は、VFW_E_INVALID_FILE_FORMAT などの他のエラー コードを返す。

注意

このメソッドは、XML ファイルで定義されている新しいオブジェクトをタイムラインに挿入する前に、タイムラインから既存のオブジェクトをクリアしない。既存のタイムラインを更新する必要がある場合は、先に IAMTimeline::ClearAllGroups を呼び出す。

IXml2Dex::Reset

IXml2Dex インターフェイス

実装されていない。

構文

HRESULT Reset(void);

IXml2Dex::WriteGrfFile

IXml2Dex インターフェイス

フィルタ グラフを .grf フォーマットでファイルに書き込む。

構文

HRESULT WriteGrfFile(
    IUnknown *pGraph,
    BSTR FileName
);

パラメータ

pGraph
フィルタ グラフの IUnknown インターフェイスを指すポインタ。
FileName
書き込むファイルの名前を指定する文字列。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。HRESULT は、次の標準的な定数の 1 つか、または一覧に示されていないその他の値となる。
E_FAIL失敗。
E_INVALIDARG引数が無効。
S_OK成功。

このメソッドは、IStorage::CreateStream および IPersist::Save メソッドの内部呼び出しで返されたエラー コードを返すこともある。詳細については、Platform SDK を参照すること。

IXml2Dex::WriteXML

IXml2Dex インターフェイス

タイムラインを XML 文字列に変換する。

構文

HRESULT WriteXML(
    IUnknown *pTimeline,
    BSTR *pbstrXML
);

パラメータ

pTimeline
タイムライン オブジェクトの IUnknown インターフェイスへのポインタ。
pbstrXML
タイムラインを記述する XML 文字列を受け取る BSTR 型の変数へのポインタ。

戻り値

成功した場合は、S_OK を返す。変換に必要なメモリが足りない場合は、E_OUTOFMEMORY を返す。それ以外の場合は、他のエラー コードを返す。

注意

このメソッドは、文字列にメモリを割り当てる。アプリケーションは SysFreeString を呼び出し、メモリを解放しなければならない。

IXml2Dex::WriteXMLFile

IXml2Dex インターフェイス

タイムラインを XML に変換し、XML データをファイルに書き込む。

構文

HRESULT WriteXMLFile(
    IUnknown *pTimeline,
    BSTR FileName
);

パラメータ

pTimeline
タイムライン オブジェクトの IUnknown インターフェイスへのポインタ。
FileName
書き込むファイルの名前を指定する文字列。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。HRESULT は、次の標準的な定数の 1 つか、または一覧に示されていないその他の値となる。
E_INVALIDARG引数が無効。
E_OUTOFMEMORYメモリ不足。
S_OK成功。

注意

このメソッドは、タイムライン内のすべてのコンポーネントを表す XML ファイルを生成する。

IXml2Dex::WriteXMLPart

IXml2Dex インターフェイス

実装されていない。

構文

HRESULT WriteXMLPart(
    IUnknown *pTimeline,
    double dStart,
    double dEnd,
    BSTR FileName
);