ISBE2GlobalEvent2::GetEventEx method (sbe.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.]

Gets a global spanning event and its data from a Stream Buffer Source filter.

Syntax

HRESULT GetEventEx(
  [in]      REFGUID        idEvt,
  [in]      ULONG          param1,
  [in]      ULONG          param2,
  [in]      ULONG          param3,
  [in]      ULONG          param4,
  [out]     BOOL           *pSpanning,
  [in, out] DWORD          *pcb,
  [out]     BYTE           *pb,
  [out]     REFERENCE_TIME *pStreamTime
);

Parameters

[in] idEvt

GUID identifying the event.

[in] param1

First event-specific parameter.

[in] param2

Second event-specific parameter.

[in] param3

Third event-specific parameter.

[in] param4

Fourth event-specific parameter.

[out] pSpanning

Receives a flag indicating whether the event is a spanning event.

[in, out] pcb

Pointer to a value specifying the buffer size. If the pb parameter is NULL, this parameter returns the required buffer size.

[out] pb

Pointer to a buffer that receives the event data. If this parameter is NULL, the pcb parameter returns the required buffer size. The structure of the event data depends on the event type. For a list of event types, see the description of the ISBE2SpanningEvent::GetEvent method.

[out] pStreamTime

Stream time of last data sample that was read from the file before the event.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

See also

ISBE2GlobalEvent2

ISBE2SpanningEvent::GetEvent