IRTCPluggableVideoDecoder::ReadRTPPacket

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/28/2008

The ReadRTPPacket method copies the encoded video data of a packet into the supplied buffer and indicates certain attributes of the packet based on the RTP header and the codec specific payload header. Because decoding an individual video frame may require multiple RTP packets, ReadRTPPacket may be called multiple times before the underlying filter interface is notified of the data available. RTC only calls into the decoder filter when the *pbLastPacket parameter is set to TRUE.

Syntax

HRESULT ReadRTPPacket(
    IUnknown *pDecoder,
  const CHAR *szFmtp,
  BYTE *pbRTPPayload,
  DWORD dwRTPPayloadSize,
  RTCRTPHeader *pRTPHeader,
  BYTE *pbEncodedFrame,
  DWORD dwEncodedFrameSize,
  DWORD *pdwFrameStartBitOffset,
  DWORD *pdwFrameEndBitOffset,
  BOOL *pfLastPacket
);

Parameters

  • pDecoder
    [in] Pointer to the codec doing the decoding, the IBaseFilter for filters
  • szFmtp
    [in] The FMTP line indicated for this payload type from the SDP of the other side
  • pbRTPPayload
    [in] Pointer of read in RTP payload
  • dwRTPPayloadSize
    [in] Number of bytes in pbRTPPayload
  • pRTPHeader
    [in] Pointer to RTP header information
  • pbEncodedFrame
    [out] Pointer to buffer to receive encoded frame
  • dwEncodedFrameSize
    [in] Number of bytes available in pbEncodedFrame
  • pdwFrameStartBitOffset
    [in] Bit offset of the beginning of the current frame in pbEncodedFrame; corresponds to first bit to receive the required sections of the RTP payload
  • pdwFrameEndBitOffset
    [out] Bit offset of the end of the current frame in pbEncodedFrame; corresponds to end of encoded video that was copied during ReadRTPPacket
  • pfLastPacket
    [out] Value of TRUE indicates that this is the last packet in the frame. RTC will call the filter only when TRUE.

Return Value

Value Description

S_OK

Indicates success

Requirements

Header RTCVideoPlugin.h
Windows Embedded CE Windows Embedded CE 6.0 R2

See Also

Reference

IRTCPluggableVideoDecoder