Win32 API 日本語リファレンス
ホームNetworking.WinSock › WSAWaitForMultipleEvents

WSAWaitForMultipleEvents

関数
複数のイベントオブジェクトがシグナルになるまで待機する。
DLLWS2_32.dll呼出規約winapiSetLastErrorあり対応OSWindows 8.1 以降

シグネチャ

// WS2_32.dll
#include <windows.h>

WAIT_EVENT WSAWaitForMultipleEvents(
    DWORD cEvents,
    const HANDLE* lphEvents,
    BOOL fWaitAll,
    DWORD dwTimeout,
    BOOL fAlertable
);

パラメーター

名前方向
cEventsDWORDin
lphEventsHANDLE*in
fWaitAllBOOLin
dwTimeoutDWORDin
fAlertableBOOLin

戻り値の型: WAIT_EVENT

各言語での呼び出し定義

// WS2_32.dll
#include <windows.h>

WAIT_EVENT WSAWaitForMultipleEvents(
    DWORD cEvents,
    const HANDLE* lphEvents,
    BOOL fWaitAll,
    DWORD dwTimeout,
    BOOL fAlertable
);
[DllImport("WS2_32.dll", SetLastError = true, ExactSpelling = true)]
static extern uint WSAWaitForMultipleEvents(
    uint cEvents,   // DWORD
    IntPtr lphEvents,   // HANDLE*
    bool fWaitAll,   // BOOL
    uint dwTimeout,   // DWORD
    bool fAlertable   // BOOL
);
<DllImport("WS2_32.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function WSAWaitForMultipleEvents(
    cEvents As UInteger,   ' DWORD
    lphEvents As IntPtr,   ' HANDLE*
    fWaitAll As Boolean,   ' BOOL
    dwTimeout As UInteger,   ' DWORD
    fAlertable As Boolean   ' BOOL
) As UInteger
End Function
' cEvents : DWORD
' lphEvents : HANDLE*
' fWaitAll : BOOL
' dwTimeout : DWORD
' fAlertable : BOOL
Declare PtrSafe Function WSAWaitForMultipleEvents Lib "ws2_32" ( _
    ByVal cEvents As Long, _
    ByVal lphEvents As LongPtr, _
    ByVal fWaitAll As Long, _
    ByVal dwTimeout As Long, _
    ByVal fAlertable As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

WSAWaitForMultipleEvents = ctypes.windll.ws2_32.WSAWaitForMultipleEvents
WSAWaitForMultipleEvents.restype = wintypes.DWORD
WSAWaitForMultipleEvents.argtypes = [
    wintypes.DWORD,  # cEvents : DWORD
    ctypes.c_void_p,  # lphEvents : HANDLE*
    wintypes.BOOL,  # fWaitAll : BOOL
    wintypes.DWORD,  # dwTimeout : DWORD
    wintypes.BOOL,  # fAlertable : BOOL
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('WS2_32.dll')
WSAWaitForMultipleEvents = Fiddle::Function.new(
  lib['WSAWaitForMultipleEvents'],
  [
    -Fiddle::TYPE_INT,  # cEvents : DWORD
    Fiddle::TYPE_VOIDP,  # lphEvents : HANDLE*
    Fiddle::TYPE_INT,  # fWaitAll : BOOL
    -Fiddle::TYPE_INT,  # dwTimeout : DWORD
    Fiddle::TYPE_INT,  # fAlertable : BOOL
  ],
  -Fiddle::TYPE_INT)
#[link(name = "ws2_32")]
extern "system" {
    fn WSAWaitForMultipleEvents(
        cEvents: u32,  // DWORD
        lphEvents: *mut *mut core::ffi::c_void,  // HANDLE*
        fWaitAll: i32,  // BOOL
        dwTimeout: u32,  // DWORD
        fAlertable: i32  // BOOL
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("WS2_32.dll", SetLastError = true)]
public static extern uint WSAWaitForMultipleEvents(uint cEvents, IntPtr lphEvents, bool fWaitAll, uint dwTimeout, bool fAlertable);
"@
$api = Add-Type -MemberDefinition $sig -Name 'WS2_32_WSAWaitForMultipleEvents' -Namespace Win32 -PassThru
# $api::WSAWaitForMultipleEvents(cEvents, lphEvents, fWaitAll, dwTimeout, fAlertable)
#uselib "WS2_32.dll"
#func global WSAWaitForMultipleEvents "WSAWaitForMultipleEvents" sptr, sptr, sptr, sptr, sptr
; WSAWaitForMultipleEvents cEvents, lphEvents, fWaitAll, dwTimeout, fAlertable   ; 戻り値は stat
; cEvents : DWORD -> "sptr"
; lphEvents : HANDLE* -> "sptr"
; fWaitAll : BOOL -> "sptr"
; dwTimeout : DWORD -> "sptr"
; fAlertable : BOOL -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
#uselib "WS2_32.dll"
#cfunc global WSAWaitForMultipleEvents "WSAWaitForMultipleEvents" int, sptr, int, int, int
; res = WSAWaitForMultipleEvents(cEvents, lphEvents, fWaitAll, dwTimeout, fAlertable)
; cEvents : DWORD -> "int"
; lphEvents : HANDLE* -> "sptr"
; fWaitAll : BOOL -> "int"
; dwTimeout : DWORD -> "int"
; fAlertable : BOOL -> "int"
; WAIT_EVENT WSAWaitForMultipleEvents(DWORD cEvents, HANDLE* lphEvents, BOOL fWaitAll, DWORD dwTimeout, BOOL fAlertable)
#uselib "WS2_32.dll"
#cfunc global WSAWaitForMultipleEvents "WSAWaitForMultipleEvents" int, intptr, int, int, int
; res = WSAWaitForMultipleEvents(cEvents, lphEvents, fWaitAll, dwTimeout, fAlertable)
; cEvents : DWORD -> "int"
; lphEvents : HANDLE* -> "intptr"
; fWaitAll : BOOL -> "int"
; dwTimeout : DWORD -> "int"
; fAlertable : BOOL -> "int"
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	ws2_32 = windows.NewLazySystemDLL("WS2_32.dll")
	procWSAWaitForMultipleEvents = ws2_32.NewProc("WSAWaitForMultipleEvents")
)

// cEvents (DWORD), lphEvents (HANDLE*), fWaitAll (BOOL), dwTimeout (DWORD), fAlertable (BOOL)
r1, _, err := procWSAWaitForMultipleEvents.Call(
	uintptr(cEvents),
	uintptr(lphEvents),
	uintptr(fWaitAll),
	uintptr(dwTimeout),
	uintptr(fAlertable),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // WAIT_EVENT
function WSAWaitForMultipleEvents(
  cEvents: DWORD;   // DWORD
  lphEvents: Pointer;   // HANDLE*
  fWaitAll: BOOL;   // BOOL
  dwTimeout: DWORD;   // DWORD
  fAlertable: BOOL   // BOOL
): DWORD; stdcall;
  external 'WS2_32.dll' name 'WSAWaitForMultipleEvents';
result := DllCall("WS2_32\WSAWaitForMultipleEvents"
    , "UInt", cEvents   ; DWORD
    , "Ptr", lphEvents   ; HANDLE*
    , "Int", fWaitAll   ; BOOL
    , "UInt", dwTimeout   ; DWORD
    , "Int", fAlertable   ; BOOL
    , "UInt")   ; return: WAIT_EVENT
●WSAWaitForMultipleEvents(cEvents, lphEvents, fWaitAll, dwTimeout, fAlertable) = DLL("WS2_32.dll", "dword WSAWaitForMultipleEvents(dword, void*, bool, dword, bool)")
# 呼び出し: WSAWaitForMultipleEvents(cEvents, lphEvents, fWaitAll, dwTimeout, fAlertable)
# cEvents : DWORD -> "dword"
# lphEvents : HANDLE* -> "void*"
# fWaitAll : BOOL -> "bool"
# dwTimeout : DWORD -> "dword"
# fAlertable : BOOL -> "bool"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。