CSourceStream::QueryId
QueryId メソッドは、ピン識別子を取得する。
構文
HRESULT QueryId(
LPWSTR *Id
);
パラメータ
Id
ピン識別子が含まれる文字列を受け取る変数へのポインタ。
戻り値
HRESULT 値を返す。次のいずれかの値を返す。
| 値 | 説明 |
| S_OK | 成功。 |
| E_OUTOFMEMORY | メモリ不足。 |
| E_POINTER | NULL ポインタ引数。 |
| VFW_E_NOT_FOUND | ピンはフィルタで見つからなかった。 |
注意
このメソッドは、IPin::QueryId メソッドを実装する。識別子文字列を作成するため、ピンはそれ自身をパラメータとして、CSource::FindPinNumber メソッドを呼び出す。FindPinNumber メソッドは、ゼロからインデックス設定されるピン番号を返す。QueryId は、1 つずつ戻り値をインクリメントし、結果を文字列に変換する。たとえば、最初のピンは "1" となり、2 番目のピンは "2" になり、以降も同様となる。
このメソッドが VFW_E_NOT_FOUND を返す場合は、フィルタのピン配列が無効であることを示す。この原因は、フィルタのバグである可能性が高い。
参照