IPropertySetter::LoadXML メソッド

  • [アーティクル]

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

注意

[非推奨。 この API は、Windows の今後のリリースから削除される可能性があります。]

 

メソッドは LoadXML 、拡張マークアップ言語 (XML) で表されるプロパティ データを読み込みます。

構文

HRESULT LoadXML(
  [in] IUnknown *pxml
);

パラメーター

pxml [in]

Microsoft XML パーサーによって作成された XML 要素の IUnknown インターフェイスへのポインター。

戻り値

HRESULT 値を返します。 使用可能な値は次のとおりです。

リターン コード 説明
S_FALSE
 プロパティ データがありません。
S_OK
 成功しました。
E_OUTOFMEMORY
 メモリ不足です。
VFW_E_INVALID_FILE_FORMAT
 形式が無効です。

 

解説

通常、アプリケーションではこのメソッドを使用する必要はありません。 DES では、内部的に使用して XTL ファイルからプロパティを読み込みます。

このメソッドを使用するには、 IXMLDocument オブジェクトを作成し、それを使用して XML ファイルを解析します。 次に、 IXMLDocument オブジェクトを使用して IXMLElement オブジェクトを 取得します。 オブジェクトにプロパティがある場合は、 IXMLElement ポインターを LoadXML メソッドに渡すことができます。 メソッドは、プロパティをプロパティ セッターに読み込みます。

Note

IXMLDocument インターフェイスと IXMLElement インターフェイスは、Microsoft XML Core Services (MSXML) バージョン 1.0 で実装されますが、より新しいバージョンの MSXML では実装されません。

 

注意

ヘッダー ファイル Qedit.h は、バージョン 7 より後の Direct3D ヘッダーと互換性がありません。

 

注意

Qedit.h を取得するには、Windows Vista および .NET Framework 3.0 用の Microsoft Windows SDK Update をダウンロードします。 Qedit.h は、Windows 7 および .NET Framework 3.5 Service Pack 1 のMicrosoft Windows SDKでは使用できません。

 

要件

要件 値
ヘッダー
Qedit.h
ライブラリ
Strmiids.lib

関連項目

IPropertySetter インターフェイス

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