IMFASFMultiplexer::GetNextPacket method (wmcontainer.h)

Article
02/22/2024

Retrieves the next output ASF packet from the multiplexer.

Syntax

HRESULT GetNextPacket(
  [out] DWORD     *pdwStatusFlags,
  [out] IMFSample **ppIPacket
);

Parameters

[out] pdwStatusFlags

Receives zero or more status flags. If more than one packet is waiting, the method sets the ASF_STATUSFLAGS_INCOMPLETE flag.

[out] ppIPacket

Receives a pointer to the IMFSample interface of the first output sample of the data packet. The caller must release the interface.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code	Description
S_OK	The method succeeded.

Remarks

The client needs to call this method, ideally after every call to IMFASFMultiplexer::ProcessSample, to get the output ASF packets. Call this method in a loop as long as the ASF_STATUSFLAGS_INCOMPLETE flag is received.

If no packets are ready, the method returns S_OK but does not return a sample in ppIPacket.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	wmcontainer.h
Library	Mfuuid.lib