TunerGetBandInfo

This function returns information in a TUNERBANDINFO structure on the specified bands, such as the type of band, its encoding, its frequency range, and the frequency tuning step between valid stations.

Syntax

DWORD TunerGetBandInfo( DWORD dwDeviceidentifier, DWORD dwBands, PTUNERBANDINFO pBandInfo, DWORD dwBufSize, DWORD *pdwActualOutSize );

Parameters

dwTuner

[in] Specifies the tuner device identifier. The first tuner has an identifier of 1, the second has an identifier of 2, and so on.

dwBands

[in] Specifies the bands for which information is desired. Use a bitwise OR to combine one or more of the following flags:

BAND_AM: Specifies an AM band.
BAND_FM: Specifies an FM band.
BAND_TV: Specifies a TV band.
BAND_CB: Specifies a CB band.
BAND_USER: Specifies a user-defined band.
BAND_WEATHER: Specifies a weather band.

dwBandInfo

[out] Specifies a pointer to an array of TUNERBANDINFO structures to be filled with band information.

dwBufSize

[in] Specifies the size, in bytes, of the buffer pointed to by dwBandInfo. This should be large enough to hold the information for the number of bands requested.

pdwActualOutSize

[out] Pointer to a DWORD that contains the actual number of bytes written to the dwBandInfo buffer.

Return Values

A positive value, which is the number of bands for which information was returned, indicates success. Zero (0) indicates failure.