IPMT::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.]

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 IPMT::GetNextTable method to retrieve the table.

Return value

The method returns an HRESULT. Possible values include those in the following table.

Return code Description
E_ACCESSDENIED
This table is already a next table.
E_INVALIDARG
Invalid argument; hNextTableAvailable cannot be NULL.
MPEG2_E_ALREADY_INITIALIZED
The method has already been called.
S_OK
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

See also

IPMT Interface