Share via


IDVB_NIT::RegisterForNextTable Method

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

  • hNextTableAvailable [in]
    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 IDVB_NIT::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

Header Declared in Dvbsiparser.h.

See Also

IDVB_NIT Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008