DirectX SDK

IDirectPlay4::GetMessageCount

The IDirectPlay4::GetMessageCount method queries for the number of messages in the receive queue for a specific local player.

HRESULT GetMessageCount(
  DPID idPlayer,
  LPDWORD lpdwCount
);

Parameters

idPlayer
ID of the player whose message count is requested. The player must be local.
lpdwCount
Pointer to a variable that will be set to the message count when this method returns.

Return Values

Returns DP_OK if successful, or one of the following error values otherwise:

DPERR_INVALIDOBJECT
DPERR_INVALIDPARAMS
DPERR_INVALIDPLAYER

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.
  Import Library: Use dplayx.lib.

See Also

IDirectPlay4::Receive