Platform SDK: DirectX

DPMSG_SENDCOMPLETE

The DPMSG_SENDCOMPLETE structure is sent to the receive queue to inform the application of the completion status of an asynchronous send. This message is generated by default whenever an asynchronous message is sent using the DPSEND_ASYNC flag in IDirectPlay4::SendEx.

typedef struct{
    DWORD    dwType;
    DPID     idFrom;
    DPID     idTo;
    DWORD    dwFlags;
    DWORD    dwPriority;
    DWORD    dwTimeout;
    LPVOID   lpContext;
    DWORD    dwMsgID;
    HRESULT  hr;
    DWORD    dwSendTime;
} DPMSG_SENDCOMPLETE, FAR *LPDPMSG_SENDCOMPLETE;
dwType
Value that identifies the message. This member is DPSYS_SENDCOMPLETE.
idFrom
DPID of the player who sent the message.
idTo
DPID of the player the message was sent to.
dwFlags
Flags specified in SendEx when the message was sent.
dwPriority
Priority that the message was sent at.
dwTimeout
Time-out specified when the message was sent (specified in SendEx). Zero indicates the default time-out.
lpContext
lpContext parameter supplied by the application to SendEx.
dwMsgID
dwMsgID returned to the application by DirectPlay through SendEx.
hr
HRESULT of the asynchronous message. Can be one of the following values.
DP_OK
The message was successfully sent.
DPERR_ABORTED
The message was canceled while it was being transmitted.
DPERR_CANCELLED
The message was canceled while it was still in the send queue.
DPERR_GENERIC
The message could not be sent.
DPERR_TIMEOUT
The message timed out and was removed from the send queue.
dwSendTime
The elapsed time, in milliseconds, between the time the message was sent by the application (by calling SendEx) and the time DirectPlay was able to send the message. This includes the time spent in the send queue and the time to hand the message off to the service provider. For guaranteed messages, this also includes the time to acknowledge delivery of the message.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dplay.h.

See Also

IDirectPlay4::SendEx