ICAT::RegisterForWhenCurrent 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 RegisterForWhenCurrent method registers the client to be notified when the table becomes current.
Syntax
HRESULT RegisterForWhenCurrent(
[in] HANDLE hNextTableIsCurrent
);
Parameters
[in] hNextTableIsCurrent
Handle to an event created by the caller. The object signals the event when the table becomes current.
Return value
The method returns an HRESULT. Possible values include those in the following table.
| Return code | Description |
|---|---|
|
This table is already a current table. |
|
Invalid argument; hNextTableIsCurrent cannot be NULL. |
|
The method has already been called. |
|
The method succeeded. |
Remarks
This method applies only to next tables. Otherwise, the method returns E_ACCESSDENIED.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | mpeg2psiparser.h |