次の方法で共有


IPin::QueryId

QueryId メソッドは、ピンの識別子を取得する。

構文

  HRESULT QueryId(
  LPWSTR *Id
);

パラメータ

Id

[out] ピン識別子が入る文字列を受け取る変数のアドレス。

戻り値

HRESULT 値を返す。可能な値は次のとおりである。

説明
S_OK 成功。
E_OUTOFMEMORY メモリ不足。
E_POINTER NULL ポインタ引数。

注意

このメソッドはグラフの永続性をサポートする。このメソッドを使ってピンの状態を保存し、IBaseFilter::FindPin メソッドを使ってその状態を復元すること。ピンの識別子文字列はフィルタ実装によって定義される。識別子はフィルタ内で一意である必要がある。

注 :   "ピン識別子" は必ずしも QueryPinInfo メソッドが返す "ピン名" と同じではない。

フィルタは Microsoft® Win32® CoTaskMemAlloc 関数を使って返された文字列を割り当てる。呼び出し元は CoTaskMemFree を使ってその文字列を必ず解放すること。

参照