Microsoft DirectX 8.1 (C++)

ITuneRequestInfo::GetNextLocator

The GetNextLocator method creates a new tune request with locator information for the next transport stream on the network.

Syntax

HRESULT GetNextLocator(
  ITuneRequest*  pCurrentRequest,
  ITuneRequest**  ppTuneRequest
);

Parameters

pCurrentRequest

[in] Specifies the ITuneRequest interface of the current tune request. NULL means to return information for the first stream.

ppTuneRequest

[out] Pointer to a variable that receives a tune request for the next transport stream.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code	Description
S_OK	The method succeeded.
E_POINTER	CurrentRequest is not valid, or TuneRequest is NULL.

Remarks

This method is used internally by the Network Provider's IScanningTuner::SeekUp and IScanningTuner::SeekDown methods, and is also useful for any Guide Store Loader that scans a network for EPG information.

See Also