Microsoft DirectX 8.0

ITuneRequest インターフェイス

すべての ITuneRequest オブジェクトは、IPersistPropertyBag もサポートする。

メソッド名説明
get_TuningSpaceチューニング空間オブジェクトを取得する。
get_ComponentsIComponent オブジェクトのコレクションを取得する。
Cloneこのチューニング要求の新しいコピーを返す。
get_Locatorネットワーク プロバイダから呼び出され、要求されたブロードキャストに関連付けられた ILocator オブジェクトを取得する。
put_Locatorネットワーク プロバイダから呼び出され、要求されたブロードキャストに関連付けられた ILocator オブジェクトを設定する。

ITuneRequest::get_TuningSpace

ITuneRequest インターフェイス

チューニング空間オブジェクトを取得する。

構文

HRESULT get_TuningSpace(
ITuningSpace** TuningSpace
    );

パラメータ

TuningSpace
[out, retval] 返されるオブジェクトに設定する ITuningSpace インターフェイス ポインタのアドレス。

戻り値

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

ITuneRequest::get_Components

ITuneRequest インターフェイス

IComponent オブジェクトのコレクションを取得する。

構文

HRESULT get_Components(
    IComponents** Components
    );

パラメータ

Components
[out, retval] 返されるオブジェクトに設定する IComponents インターフェイス ポインタのアドレス。

戻り値

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

注意

チューニング要求には必ず Components コレクションが関連付けられているが、このコレクションは空である可能性がある。

ITuneRequest::Clone

ITuneRequest インターフェイス

このチューニング要求の新しいコピーを返す。

構文

HRESULT Clone(
    ITuneRequest** NewTuneRequest
    );

パラメータ

NewTuneRequest
[out, retval] 新しいオブジェクトに設定する ITuneRequest インターフェイス ポインタのアドレス。

戻り値

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

注意

このメソッドはオブジェクトの "ディープ コピー" を実行する。つまり、Components、LanguageComponents などを含むすべてのサブオブジェクトもコピーされる。

ITuneRequest::get_Locator

ITuneRequest インターフェイス

ネットワーク プロバイダから呼び出され、要求されたブロードキャストに関連付けられた ILocator オブジェクトを取得する。

構文

HRESULT get_Locator(
    ILocator** Locator
    );

パラメータ

Locator
[out, retval] 新しいオブジェクトに設定する ILocator インターフェイス ポインタのアドレス。

戻り値

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

注意

ロケータは、要求されたブロードキャストを取得する方法や場所に関する情報を取得するために、ネットワーク プロバイダとトランスポート情報フィルタ (TIF) から使用される。この情報には、変調の方式、エラー訂正方式、および周波数が含まれる。アプリケーションは下位レベルの細かいチューニング処理に関与しないため、通常、アプリケーションでこの情報を使用することはない。

ITuneRequest::put_Locator

ITuneRequest インターフェイス

ネットワーク プロバイダから呼び出され、要求されたブロードキャストに関連付けられた ILocator オブジェクトを設定する。

構文

HRESULT put_Locator(
    ILocator* Locator
    );

パラメータ

Locator
[in] 新しいロケータを指定する ILocator インターフェイスへのポインタ。

戻り値

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