次の方法で共有

ITuningSpaceContainer::_TuningSpacesForCLSID

  • [アーティクル]

_TuningSpacesForCLSID メソッドは、指定された CLSID と一致するチューニング空間のコレクションを取得する。

構文

  HRESULT _TuningSpacesForCLSID(
    REFCLSID SpaceCLSID,
    ITuningSpaces** ppTuningSpaces
);

パラメータ

SpaceCLSID

[in] 取得するチューニング空間の CLSID を指定する。

ppTuningSpaces

[out] ITuningSpaces インターフェイス ポインタを受け取る変数のアドレス。呼び出し元はそのインターフェイスを解放しなければならない。

戻り値

成功した場合は S_OK を返す。メソッドが失敗した場合は、標準 COM IErrorInfo インターフェイスを使ってエラー情報を取得できる。

注意

CLSID はチューニング空間を実装するオブジェクトを表す。同じオブジェクトが複数の関連するチューニング空間を実装する場合がある。たとえば、ATSC デジタル アンテナおよび ATSC デジタル ケーブルは、どちらも ATSCTuningSpace オブジェクト (CLSID_ATSCTuningSpace) によってサポートされる。

このメソッドは、ITuningSpace::get_CLSID メソッドが返す CLSID と一致するものを検索する。返されるコレクションは空の場合がある。返されたチューニング空間の数を調べるには、ITuningSpaces::get_Count を呼び出す。

参照