ICAT::RegisterForNextTable

  • Article
 
Microsoft DirectShow 9.0

ICAT::RegisterForNextTable

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

Return Values

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: Include mpeg2psiparser.h.

See Also