Share via


ITuneRequestInfo::GetNextLocator method (bdatif.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

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

Syntax

HRESULT GetNextLocator(
  [in]  ITuneRequest *CurrentRequest,
  [out] ITuneRequest **TuneRequest
);

Parameters

[in] CurrentRequest

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

[out] TuneRequest

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

Return value

The method returns an HRESULT. Possible values include 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.

Currently this method is not implemented for DVB-C or DVB-S networks, and the method returns E_NOTIMPL. The method is implemented for DVB-T.

Requirements

Requirement Value
Target Platform Windows
Header bdatif.h

See also

Error and Success Codes

ITuneRequestInfo Interface