DPN_MSGID_SEND_COMPLETE 메시지

비동기 송신 메시지 요구가 완료 하면, Microsoft® DirectPlay® 는 DPN_MSGID_SEND_COMPLETE 메시지를 생성한다.

DPNMSG_SEND_COMPLETE 구조체에는,DPN_MSGID_SEND_COMPLETE 시스템 메시지에 관한 정보가 포함된다.

구문

typedef struct _DPNMSG_SEND_COMPLETE {
    DWORD dwSize;
    DPNHANDLE hAsyncOp;
    PVOID pvUserContext;
    HRESULT hResultCode;
    DWORD dwSendTime;
    DWORD dwFirstFrameRTT;
    DWORD dwFirstRetryCount;
    DWORD dwSendCompleteFlags;
    const DPN_BUFFER_DESC pBuffers;
    DWORD dwNumBuffers;
}  DPNMSG_SEND_COMPLETE, *PDPNMSG_SEND_COMPLETE;

멤버

dwSize
이 구조체의 사이즈.
hAsyncOp
비동기 처리 핸들.
pvUserContext
IDirectPlay8Client::Send ,IDirectPlay8Peer::SendTo , 및 IDirectPlay8Server::SendTo 메서드로 지정되는 사용자 문맥.
hResultCode
송신 메시지 요구의 결과를 나타내는 HRESULT.
dwSendTime
송신 호출로부터 종료할 때까지의 합계 시간 (밀리 세컨드 단위).
dwFirstFrameRTT
이 메시지의 계측이 끝난 왕복 시간 (이용할 수 있는 경우). 최초의 시행으로 도착했기 때문에 재발송신 할 필요가 없는, 신뢰성의 높은 메시지에만 이 값은 이용할 수 있다. 다른 모든 메시지에서는, 이 필드는 -1 으로 설정된다. 복수의 프레임에 걸치는 큰 메시지의 경우, 이 값은 최초로 송신된 프레임의 계측이 끝난 왕복 시간을 나타낸다.
dwFirstRetryCount
신뢰성이 높은 메시지의 경우, 배송이 성공하기까지 DirectPlay 가 메시지를 재발송신 하는 회수를 나타낸다. 신뢰성이 낮은 메시지의 경우, 이 필드는 항상 -1 으로 설정된다.
dwSendCompleteFlags
메시지의 송신 방법을 기술하는 다음의 플래그를 지정한다.
DPNSENDCOMPLETE_GUARANTEED
메시지는 보증 첨부로 송신되었다.
DPNSENDCOMPLETE_COALESCED
메시지는 결합해 송신되었다.
pBuffers
송신된 DPN_BUFFER_DESC 구조체의 배열의 포인터.
dwNumBuffers
pBuffers 배열내의 DPN_BUFFER_DESC 구조체의 수.

주의

DPN_OK 가 포함된, 메시지 콜백 함수로부터의 반환값.
IDirectPlay8Peer::SendTo,IDirectPlay8Client::Send, 또는 IDirectPlay8Server::SendTo 가 불려 갔을 때에 DPNSEND_NOCOPY 플래그가 지정되고 있었을 경우,pBuffers 멤버와 dwNumBuffers 멤버는, 송신 호출로 건네받은 것과 같은 버퍼 포인터와 사이즈를 보관 유지하는 배열을 참조한다. DPNSEND_NOCOPY 플래그가 지정되지 않은 경우,pBuffers 는 NULL 로 설정되어dwNumBuffers 는 0 으로 설정된다.

메시지의 정보

헤더 dplay8.h
최저한의 operating system Windows 98, Pocket PC 2002

헤더	dplay8.h
최저한의 operating system	Windows 98, Pocket PC 2002