IDirectPlay8Peer::GetSendQueueInfo

Used by the application to monitor the size of the send queue.

HRESULT GetSendQueueInfo(
const DPNID dpnid,
DWORD *const pdwNumMsgs,
DWORD *const pdwNumBytes,
const DWORD dwFlags
);

Parameters

dpnid

[in] DPNID of the player to get send queue information for.

pdwNumMsgs

[out] Pointer to a variable of type DWORD that contains the number of messages currently queued. This value is optional, and can be set to NULL.

pdwNumBytes

[out] Pointer to a variable of type DWORD that specifies the total number of bytes of data of the messages currently queued. This value is optional, and can be set to NULL.

dwFlags

[in] You can specify the DPNGETSENDQUEUEINFO_PRIORITY_NORMAL, DPNGETSENDQUEUEINFO_PRIORITY_HIGH, or DPNGETSENDQUEUEINFO_PRIORITY_LOW flag to inquire about specific messages of that priority.

Return Values

Returns S_OK if successful, or the following error value.

Remarks

Microsoft® DirectPlay® will not send messages faster than the receiving computer can process them. As a result, if the sending computer is sending faster than the receiver can receive, messages accumulate in the sender's queue. If the application registers that the send queue is growing too large, it should slow the rate that messages are sent.

You cannot set both pdwNumMsgs and pdwNumBytes to NULL. At least one of them must be set to a valid pointer.

Requirements

  Windows NT/2000/XP: Available as a redistributable for Windows 2000 and later.
  Windows 98/Me: Available as a redistributable for Windows 98 and later.
  Header: Declared in Dplay8.h.