Platform SDK: DirectX |
IDirectPlay4::CancelPriority メソッドは、まだ送信キューに入っている特定の、または特定範囲の優先順位のメッセージを、すべて取り消すときに使用する。CancelPriority は、非同期メッセージにのみ適用される。
メッセージ キューに残っているものの、一部が既に送信されているメッセージについては、取り消すことはできない。グループに送信されるメッセージで、そのグループの一部に既に送信されている場合は取り消すことができない。
メッセージを取り消しても、メッセージが取り消されたことを示す DPMSG_SENDCOMPLETE システム メッセージは生成される。
HRESULT CancelPriority( DWORD dwMinPriority, DWORD dwMaxPriority, DWORD dwFlags );
成功した場合は DP_OK を返す。失敗した場合は、次のエラー値のいずれかを返す。
DPERR_INVALIDFLAGS |
DPERR_INVALIDPARAMS |
DPERR_UNSUPPORTED |
送信キューにメッセージがまったくない場合は、DP_OK を返す。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dplay.h で宣言。
インポート ライブラリ : dplayx.lib を使用。
IDirectPlay4::SendEx、IDirectPlay4::Send、IDirectPlay4::GetMessageQueue、DPMSG_SENDCOMPLETE、IDirectPlay4::CancelMessage