ICAT::RegisterForNextTable method (mpeg2psiparser.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.]
This topic applies to Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 and later.
The RegisterForNextTable method registers the client to be notified when a next table arrives that will replace the current table.
Syntax
HRESULT RegisterForNextTable(
[in] HANDLE hNextTableAvailable
);
Parameters
[in] hNextTableAvailable
Handle to an event created by the caller. The object signals the event when the next table arrives. When the event is signaled, call the ICAT::GetNextTable method to retrieve the table.
Return value
The method returns an HRESULT. Possible values include those in the following table.
| Return code | Description |
|---|---|
|
This table is already a next table. |
|
Invalid argument; hNextTableAvailable cannot be NULL. |
|
The method has already been called. |
|
The method succeeded. |
Remarks
This method applies only to current tables. Otherwise, the method returns E_ACCESSDENIED.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | mpeg2psiparser.h |