ISCTE_EAS::GetTableDescriptorByTag method (atscpsipparser.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 GetTableDescriptorByTag method searches the EAS table for a descriptor with the specified descriptor tag.
Syntax
HRESULT GetTableDescriptorByTag(
[in] BYTE bTag,
[in, out] DWORD *pdwCookie,
[out] IGenericDescriptor **ppDescriptor
);
Parameters
[in] bTag
The descriptor tag to search for.
[in, out] pdwCookie
A pointer to a variable that specifies the start position in the descriptor list. This parameter can be NULL. If the value is NULL, the search starts from the first descriptor in the list. Otherwise, the search starts from the position given in *pdwCookie. When the method returns, the pdwCookie parameter contains the position of the next matching descriptor, if any. You can use this parameter to iterate through the descriptor list, looking for every instance of a particular descriptor tag.
[out] ppDescriptor
Receives a pointer to the IGenericDescriptor interface. Use this interface to retrieve the information in the descriptor. The caller must release the interface.
Return value
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
Return code | Description |
---|---|
|
The specified tag was not found. |
|
Index out of bounds. |
|
The ISCTE_EAS::Initialize method was not called. |
|
The record contains at least one more descriptor with this tag. |
|
The record does not contain any more descriptors with this tag. |
|
The method succeeded. |
Requirements
Minimum supported client | Windows�Vista [desktop apps only] |
Minimum supported server | None supported |
Target Platform | Windows |
Header | atscpsipparser.h |