Microsoft DirectX 8.0 |
すべての ITuneRequest オブジェクトは、IPersistPropertyBag もサポートする。
メソッド名 説明 get_TuningSpace チューニング空間オブジェクトを取得する。 get_Components IComponent オブジェクトのコレクションを取得する。 Clone このチューニング要求の新しいコピーを返す。 get_Locator ネットワーク プロバイダから呼び出され、要求されたブロードキャストに関連付けられた ILocator オブジェクトを取得する。 put_Locator ネットワーク プロバイダから呼び出され、要求されたブロードキャストに関連付けられた ILocator オブジェクトを設定する。
チューニング空間オブジェクトを取得する。
構文
HRESULT get_TuningSpace( ITuningSpace** TuningSpace );
パラメータ
- TuningSpace
- [out, retval] 返されるオブジェクトに設定する ITuningSpace インターフェイス ポインタのアドレス。
戻り値
成功した場合は、S_OK を返す。失敗した場合は、標準の IErrorInfo インターフェイスを使ってエラー情報を取得できる。
IComponent オブジェクトのコレクションを取得する。
構文
HRESULT get_Components( IComponents** Components );
パラメータ
- Components
- [out, retval] 返されるオブジェクトに設定する IComponents インターフェイス ポインタのアドレス。
戻り値
成功した場合は、S_OK を返す。失敗した場合は、標準の IErrorInfo インターフェイスを使ってエラー情報を取得できる。
注意
チューニング要求には必ず Components コレクションが関連付けられているが、このコレクションは空である可能性がある。
このチューニング要求の新しいコピーを返す。
構文
HRESULT Clone( ITuneRequest** NewTuneRequest );
パラメータ
- NewTuneRequest
- [out, retval] 新しいオブジェクトに設定する ITuneRequest インターフェイス ポインタのアドレス。
戻り値
成功した場合は、S_OK を返す。失敗した場合は、標準の IErrorInfo インターフェイスを使ってエラー情報を取得できる。
注意
このメソッドはオブジェクトの "ディープ コピー" を実行する。つまり、Components、LanguageComponents などを含むすべてのサブオブジェクトもコピーされる。
ネットワーク プロバイダから呼び出され、要求されたブロードキャストに関連付けられた ILocator オブジェクトを取得する。
構文
HRESULT get_Locator( ILocator** Locator );
パラメータ
- Locator
- [out, retval] 新しいオブジェクトに設定する ILocator インターフェイス ポインタのアドレス。
戻り値
成功した場合は、S_OK を返す。失敗した場合は、標準の IErrorInfo インターフェイスを使ってエラー情報を取得できる。
注意
ロケータは、要求されたブロードキャストを取得する方法や場所に関する情報を取得するために、ネットワーク プロバイダとトランスポート情報フィルタ (TIF) から使用される。この情報には、変調の方式、エラー訂正方式、および周波数が含まれる。アプリケーションは下位レベルの細かいチューニング処理に関与しないため、通常、アプリケーションでこの情報を使用することはない。
ネットワーク プロバイダから呼び出され、要求されたブロードキャストに関連付けられた ILocator オブジェクトを設定する。
構文
HRESULT put_Locator( ILocator* Locator );
パラメータ
- Locator
- [in] 新しいロケータを指定する ILocator インターフェイスへのポインタ。
戻り値
成功した場合は、S_OK を返す。失敗した場合は、標準の IErrorInfo インターフェイスを使ってエラー情報を取得できる。