Freigeben über


IDvbLogicalChannel2Descriptor::GetListRecordLogicalChannelAndVisibility method (dvbsiparser.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.]

Gets the visible_service_flag and logical_channel_number fields from a Digital Video Broadcast (DVB) logical channel descriptor. The visible_service_flag indicates whether a service record in the DVB logical channel descriptor is visible through the receiver service list and can be selected. The logical_channel_number field contains a broadcaster-defined channel number that is used to order services.

Syntax

HRESULT GetListRecordLogicalChannelAndVisibility(
  [in]  BYTE bListIndex,
  [in]  BYTE bRecordIndex,
  [out] WORD *pwVal
);

Parameters

[in] bListIndex

Specifies the channel list record number, indexed from zero. Call the GetCountOfLists method to get the number of channel list records in the logical channel descriptor.

[in] bRecordIndex

Specifies the service record number, indexed from zero. Call the GetListCountOfRecords method to get the number of service records in the logical channel descriptor.

[out] pwVal

Receives the visible_service_flag (defined by bit 15) and logical_channel_number (defined by bits 0 - 9) field values.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The combinations of visible_service_flag and local_channel_number field values have the following meanings.

visible_service_flag logical_channel_number Meaning
0 0 Service not suitable for selection by the user. For example, the value zero may be used for data services intended only for selection from interactive applications or for firmware download services.
1 0 Reserved for future use.
0 1-1024 Reserved for future use.
1 1-999 Service is displayed in service lists and Event Schedule Guide (ESG). Service is accessible via P+/- keys or from numeric keys (same value as decimal value of logical_channel_number).
1 > 999 Reserved.

Requirements

Requirement Value
Minimum supported client Windows�7 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header dvbsiparser.h

See also

GetCountOfLists

GetListCountOfRecords

IDvbLogicalChannel2Descriptor