IPAT::RegisterForWhenCurrent Method

The RegisterForWhenCurrent method registers the client to be notified when the table becomes current.

Syntax

HRESULT RegisterForWhenCurrent(
  [in]  HANDLE hNextTableIsCurrent
);

Parameters

  • hNextTableIsCurrent [in]
    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

E_ACCESSDENIED

This table is already a current table.

E_INVALIDARG

Invalid argument; hNextTableIsCurrent cannot be NULL.

MPEG2_E_ALREADY_INITIALIZED

The method has already been called.

S_OK

The method succeeded.

Remarks

This method applies only to next tables. Otherwise, the method returns E_ACCESSDENIED.

Requirements

Header Declared in Mpeg2PsiParser.h.

See Also

IPAT Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008