Microsoft DirectX 9.0

IXDSCodec::GetXDSPacket

This topic applies to Windows XP Service Pack 1 only.

The GetXDSPacket method retrieves the most recent XDS packet.

Syntax

HRESULT GetXDSPacket(
    long  *pXDSClassPkt
    long  *pXDSTypePkt
    BSTR  *pBstrXDSPkt
    long  *pPktSeqID
    long  *pCallSeqID
    REFERENCE_TIME  *pTimeStart
    REFERENCE_TIME  *pTimeEnd
);

Parameters

pXDSClassPkt

[out]  Pointer to a variable that receives the packet class.

pXDSTypePkt

[out]  Pointer to a variable that receives the class-specific packet type.

pBstrXDSPkt

[out]  Pointer to a variable that receives the packet as a BSTR value.

pPktSeqID

[out]  Pointer to a variable that receives the number of ratings packets that have been decoded. This information can be used for diagnostic purposes.

pCallSeqID

[out]  Pointer to a variable that receives the number of times this method has been called for the current ratings packet. This information can be used for diagnostic purposes.

pTimeStart

[out]  Pointer to a variable that receives the start time of the sample containing the packet.

pTimeEnd

[out]  Pointer to a variable that receives the stop time of the sample containing the packet.

Return Values

Returns an HRESULT value. Possible values include those in the following table.

Value Description
E_POINTER NULL pointer argument
S_OK Success

Remarks

The returned BSTR contains binary data which might include embedded NULL characters. The caller must free the returned BSTR by calling SysFreeString.

See Also