IPin::QueryId
QueryId メソッドは、ピンの識別子を取得する。
構文
HRESULT QueryId(
LPWSTR *Id
);
パラメータ
Id
[out] ピン識別子が入る文字列を受け取る変数のアドレス。
戻り値
HRESULT 値を返す。可能な値は次のとおりである。
値 | 説明 |
S_OK | 成功。 |
E_OUTOFMEMORY | メモリ不足。 |
E_POINTER | NULL ポインタ引数。 |
注意
このメソッドはグラフの永続性をサポートする。このメソッドを使ってピンの状態を保存し、IBaseFilter::FindPin メソッドを使ってその状態を復元すること。ピンの識別子文字列はフィルタ実装によって定義される。識別子はフィルタ内で一意である必要がある。
注 : "ピン識別子" は必ずしも QueryPinInfo メソッドが返す "ピン名" と同じではない。
フィルタは Microsoft® Win32® CoTaskMemAlloc 関数を使って返された文字列を割り当てる。呼び出し元は CoTaskMemFree を使ってその文字列を必ず解放すること。
参照