Compartilhar via


IMpeg2Stream::SupplyDataBuffer

 
Microsoft DirectShow 9.0

IMpeg2Stream::SupplyDataBuffer

The SupplyDataBuffer method provides a buffer for the Mpeg2Stream object to write data.

Syntax

  HRESULT SupplyDataBuffer(
  PMPEG_STREAM_BUFFER  pStreamBuffer
);

Parameters

pStreamBuffer

[in]  Pointer to an MPEG_STREAM_BUFFER structure allocated by the caller. This structure contains a pointer to the buffer, also allocated by the caller. The buffer must be at least 4096 bytes.

Return Values

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

Return code Description
S_OK The method succeeded.
E_INVALIDARG Invalid argument or NULL parameter.
E_OUTOFMEMORY Insufficient memory.
E_FAIL Failure.

Remarks

The first time this method is called, it starts a worker thread that streams data to the buffer. When the data arrives, the MPEG2Stream object signals the event that was passed to the IMpeg2Stream::Initialize method. (Typically an application specifies the event handle when it calls IMpeg2Data::GetStreamOfSections.)

When the event is signaled, examine the hr field of the MPEG_STREAM_BUFFER structure. If this value is a success code, the request was successful and the buffer contains valid data. To get more data, call the SupplyDataBuffer method again and wait for the event to be signaled.

The section headers are not converted from network byte order or otherwise processed.

If the object is still waiting for data, this method returns E_FAIL.

Requirements

Header: Include Mpeg2data.h.

See Also