IPropertySetter::SaveToBlob メソッド

  • [アーティクル]

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

注意

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

 

メソッドは SaveToBlob 、プロパティ データを永続化形式に保存します。

構文

HRESULT SaveToBlob(
  [out] LONG *pcSize,
  [out] BYTE **ppb
);

パラメーター

pcSize [out]

データのサイズをバイト単位で受け取ります。

ppb [out]

データを受信するバイト配列へのポインターを受け取ります。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

メソッドは、バイト配列にメモリを割り当てます。 呼び出し元は、 CoTaskMemFree 関数を使用して解放する必要があります。

すべてのプロパティ名と値は、長さが 40 文字に切り捨てられます。 このため、XML は優先される永続化形式です。 「IXml2Dex インターフェイス」を参照してください。

注意

ヘッダー ファイル 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 インターフェイス

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