WSAWaitForMultipleEvents
関数シグネチャ
// WS2_32.dll
#include <windows.h>
WAIT_EVENT WSAWaitForMultipleEvents(
DWORD cEvents,
const HANDLE* lphEvents,
BOOL fWaitAll,
DWORD dwTimeout,
BOOL fAlertable
);パラメーター
| 名前 | 型 | 方向 | 説明 |
|---|---|---|---|
| cEvents | DWORD | in | lphEvents が指す配列内のイベントオブジェクトハンドルの数。イベントオブジェクトハンドルの最大数は WSA_MAXIMUM_WAIT_EVENTS です。1 つ以上のイベントを指定する必要があります。 |
| lphEvents | HANDLE* | in | イベントオブジェクトハンドルの配列へのポインター。配列には異なる種類のオブジェクトのハンドルを含めることができます。fWaitAll パラメーターが TRUE に設定されている場合、同じハンドルの複製を複数含めることはできません。 待機が保留中にこれらのハンドルのいずれかが閉じられた場合、WSAWaitForMultipleEvents の動作は未定義です。 ハンドルには SYNCHRONIZE アクセス権が必要です。詳細については、Standard Access Rights を参照してください。 |
| fWaitAll | BOOL | in | 待機の種類を指定する値。TRUE の場合、lphEvents 配列内のすべてのオブジェクトの状態がシグナル状態になったときに関数が制御を返します。FALSE の場合、いずれかのイベントオブジェクトがシグナル状態になったときに関数が制御を返します。後者の場合、戻り値から WSA_WAIT_EVENT_0 を引いた値が、関数を復帰させる原因となったイベントオブジェクトのインデックスを示します。呼び出し中に複数のイベントオブジェクトがシグナル状態になった場合は、シグナル状態のすべてのイベントオブジェクトの中で最小のインデックス値を持つイベントオブジェクトの配列インデックスになります。 |
| dwTimeout | DWORD | in | タイムアウト間隔(ミリ秒単位)。fWaitAll パラメーターで指定された条件が満たされていなくても、タイムアウト間隔が経過すると WSAWaitForMultipleEvents は制御を返します。dwTimeout パラメーターが 0 の場合、WSAWaitForMultipleEvents は指定されたイベントオブジェクトの状態を検査し、ただちに制御を返します。dwTimeout が WSA_INFINITE の場合、WSAWaitForMultipleEvents は無期限に待機します。つまり、タイムアウト間隔が経過することはありません。 |
| fAlertable | BOOL | in | システムが I/O 完了ルーチンを実行できるように、スレッドをアラート可能な待機状態にするかどうかを指定する値。TRUE の場合、スレッドはアラート可能な待機状態に置かれ、システムが I/O 完了ルーチンを実行したときに WSAWaitForMultipleEvents が制御を返すことができます。この場合、WSA_WAIT_IO_COMPLETION が返され、待機していたイベントはまだシグナル状態になっていません。アプリケーションは再度 WSAWaitForMultipleEvents 関数を呼び出す必要があります。FALSE の場合、スレッドはアラート可能な待機状態に置かれず、I/O 完了ルーチンは実行されません。 |
戻り値の型: WAIT_EVENT
公式ドキュメント
指定したイベントオブジェクトのいずれか、またはすべてがシグナル状態になったとき、タイムアウト間隔が経過したとき、または I/O 完了ルーチンが実行されたときに制御を返します。
戻り値
WSAWaitForMultipleEvents 関数が成功した場合、戻り値は次のいずれかの値になります。
| 戻り値 | 意味 |
|---|---|
|
fWaitAll パラメーターが TRUE の場合、戻り値は指定したすべてのイベントオブジェクトがシグナル状態になったことを示します。
fWaitAll パラメーターが FALSE の場合、戻り値から WSA_WAIT_EVENT_0 を引いた値は、待機を満たしたシグナル状態のイベントオブジェクトの lphEvents 配列インデックスを示します。呼び出し中に複数のイベントオブジェクトがシグナル状態になった場合、戻り値は、シグナル状態のすべてのイベントオブジェクトの中で最小のインデックス値を持つイベントオブジェクトの lphEvents 配列インデックスを示します。 |
| 1 つ以上の I/O 完了ルーチンが実行されたことにより待機が終了しました。待機していたイベントはまだシグナル状態になっていません。アプリケーションは再度 WSAWaitForMultipleEvents 関数を呼び出す必要があります。この戻り値は、fAlertable パラメーターが TRUE の場合にのみ返されます。 | |
| タイムアウト間隔が経過し、fWaitAll パラメーターで指定された条件が満たされませんでした。I/O 完了ルーチンは実行されませんでした。 |
WSAWaitForMultipleEvents 関数が失敗した場合、戻り値は WSA_WAIT_FAILED です。次の表に、WSAGetLastError で拡張エラー情報を取得する際に使用できる値を示します。
| エラーコード | 意味 |
|---|---|
| WSANOTINITIALISED | この関数を使用する前に、 WSAStartup の呼び出しが成功している必要があります。 |
| WSAENETDOWN | ネットワークサブシステムが失敗しました。 |
| WSAEINPROGRESS | ブロッキングの Windows Sockets 1.1 呼び出しが進行中であるか、サービスプロバイダーがコールバック関数を処理中です。 |
| WSA_NOT_ENOUGH_MEMORY | 操作を完了するのに十分な空きメモリがありませんでした。 |
| WSA_INVALID_HANDLE | lphEvents 配列内の値の 1 つ以上が、有効なイベントオブジェクトハンドルではありません。 |
| WSA_INVALID_PARAMETER | cEvents パラメーターに有効なハンドル数が含まれていません。 |
解説(Remarks)
WSAWaitForMultipleEvents 関数は、待機条件が満たされたかどうかを判定します。条件が満たされていない場合、呼び出し元のスレッドは待機状態に入ります。条件が満たされるのを待っている間、プロセッサー時間は消費されません。
WSAWaitForMultipleEvents 関数は、指定したオブジェクトのいずれか 1 つまたはすべてがシグナル状態になったとき、またはタイムアウト間隔が経過したときに制御を返します。
bWaitAll パラメーターが TRUE の場合、待機操作はすべてのオブジェクトの状態がシグナル状態に設定されたときにのみ完了します。すべてのオブジェクトの状態がシグナル状態に設定されるまで、関数は指定されたオブジェクトの状態を変更しません。
bWaitAll パラメーターが FALSE の場合、WSAWaitForMultipleEvents は lphEvents 配列内のハンドルをインデックス 0 から順に検査し、いずれかのオブジェクトがシグナル状態になるまで続けます。複数のオブジェクトがシグナル状態になった場合、関数は lphEvents 配列内でオブジェクトがシグナル状態になった最初のハンドルのインデックスを返します。
この関数は、fAlertable パラメーターを TRUE に設定することで、アラート可能な待機を実行するためにも使用されます。これにより、呼び出し元スレッドによってシステムが I/O 完了ルーチンを実行したときに、関数が制御を返せるようになります。
システムが I/O 完了ルーチン(非同期プロシージャ呼び出し、つまり APC)を実行するには、スレッドがアラート可能な待機状態にある必要があります。そのため、I/O 完了ルーチンを伴う保留中の非同期操作がある状態で、アプリケーションが fAlertable パラメーターを FALSE にして WSAWaitForMultipleEvents を呼び出した場合、それらの I/O 操作が完了しても、I/O 完了ルーチンは実行されません。
fAlertable パラメーターが TRUE で、保留中の操作の 1 つが完了すると、APC が実行され、WSAWaitForMultipleEvents は WSA_IO_COMPLETION を返します。 保留中のイベントはまだシグナル状態になっていません。アプリケーションは再度 WSAWaitForMultipleEvents 関数を呼び出す必要があります。
イベントオブジェクトのシグナル状態を待つことなくアラート可能な待機状態を必要とするアプリケーションは、Windows の SleepEx 関数を使用してください。
WSAWaitForMultipleEvents の現在の実装は、WaitForMultipleObjectsEx 関数を呼び出します。
サンプルコード
次のコード例は、WSAWaitForMultipleEvents 関数の使用方法を示しています。#ifndef UNICODE
#define UNICODE
#endif
#define WIN32_LEAN_AND_MEAN
#include <winsock2.h>
#include <Ws2tcpip.h>
#include <stdio.h>
// Link with ws2_32.lib
#pragma comment(lib, "Ws2_32.lib")
#define DATA_BUFSIZE 4096
int main()
{
//-----------------------------------------
// Declare and initialize variables
WSADATA wsaData = { 0 };
int iResult = 0;
BOOL bResult = TRUE;
WSABUF DataBuf;
char buffer[DATA_BUFSIZE];
DWORD EventTotal = 0;
DWORD RecvBytes = 0;
DWORD Flags = 0;
DWORD BytesTransferred = 0;
WSAEVENT EventArray[WSA_MAXIMUM_WAIT_EVENTS];
WSAOVERLAPPED AcceptOverlapped;
SOCKET ListenSocket = INVALID_SOCKET;
SOCKET AcceptSocket = INVALID_SOCKET;
DWORD Index;
//-----------------------------------------
// Initialize Winsock
// Initialize Winsock
iResult = WSAStartup(MAKEWORD(2, 2), &wsaData);
if (iResult != 0) {
wprintf(L"WSAStartup failed: %d\n", iResult);
return 1;
}
//-----------------------------------------
// Create a listening socket bound to a local
// IP address and the port specified
ListenSocket = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
if (ListenSocket == INVALID_SOCKET) {
wprintf(L"socket failed with error = %d\n", WSAGetLastError());
WSACleanup();
return 1;
}
u_short port = 27015;
char *ip;
sockaddr_in service;
service.sin_family = AF_INET;
service.sin_port = htons(port);
hostent *thisHost;
thisHost = gethostbyname("");
if (thisHost == NULL) {
wprintf(L"gethostbyname failed with error = %d\n", WSAGetLastError());
closesocket(ListenSocket);
WSACleanup();
return 1;
}
ip = inet_ntoa(*(struct in_addr *) *thisHost->h_addr_list);
service.sin_addr.s_addr = inet_addr(ip);
//-----------------------------------------
// Bind the listening socket to the local IP address
// and port number
iResult = bind(ListenSocket, (SOCKADDR *) & service, sizeof (SOCKADDR));
if (iResult != 0) {
wprintf(L"bind failed with error = %d\n", WSAGetLastError());
closesocket(ListenSocket);
WSACleanup();
return 1;
}
//-----------------------------------------
// Set the socket to listen for incoming
// connection requests
iResult = listen(ListenSocket, 1);
if (iResult != 0) {
wprintf(L"listen failed with error = %d\n", WSAGetLastError());
closesocket(ListenSocket);
WSACleanup();
return 1;
}
wprintf(L"Listening...\n");
//-----------------------------------------
// Accept and incoming connection request
AcceptSocket = accept(ListenSocket, NULL, NULL);
if (AcceptSocket == INVALID_SOCKET) {
wprintf(L"accept failed with error = %d\n", WSAGetLastError());
closesocket(ListenSocket);
WSACleanup();
return 1;
}
wprintf(L"Client Accepted...\n");
//-----------------------------------------
// Create an event handle and setup an overlapped structure.
EventArray[EventTotal] = WSACreateEvent();
if (EventArray[EventTotal] == WSA_INVALID_EVENT) {
wprintf(L"WSACreateEvent failed with error = %d\n", WSAGetLastError());
closesocket(AcceptSocket);
closesocket(ListenSocket);
WSACleanup();
return 1;
}
ZeroMemory(&AcceptOverlapped, sizeof (WSAOVERLAPPED));
AcceptOverlapped.hEvent = EventArray[EventTotal];
DataBuf.len = DATA_BUFSIZE;
DataBuf.buf = buffer;
EventTotal++;
//-----------------------------------------
// Call WSARecv to receive data into DataBuf on
// the accepted socket in overlapped I/O mode
if (WSARecv(AcceptSocket, &DataBuf, 1, &RecvBytes, &Flags, &AcceptOverlapped, NULL) ==
SOCKET_ERROR) {
iResult = WSAGetLastError();
if (iResult != WSA_IO_PENDING)
wprintf(L"WSARecv failed with error = %d\n", iResult);
}
//-----------------------------------------
// Process overlapped receives on the socket
while (1) {
//-----------------------------------------
// Wait for the overlapped I/O call to complete
Index = WSAWaitForMultipleEvents(EventTotal, EventArray, FALSE, WSA_INFINITE, FALSE);
//-----------------------------------------
// Reset the signaled event
bResult = WSAResetEvent(EventArray[Index - WSA_WAIT_EVENT_0]);
if (bResult == FALSE) {
wprintf(L"WSAResetEvent failed with error = %d\n", WSAGetLastError());
}
//-----------------------------------------
// Determine the status of the overlapped event
bResult =
WSAGetOverlappedResult(AcceptSocket, &AcceptOverlapped, &BytesTransferred, FALSE,
&Flags);
if (bResult == FALSE) {
wprintf(L"WSAGetOverlappedResult failed with error = %d\n", WSAGetLastError());
}
//-----------------------------------------
// If the connection has been closed, close the accepted socket
if (BytesTransferred == 0) {
wprintf(L"Closing accept Socket %d\n", AcceptSocket);
closesocket(ListenSocket);
closesocket(AcceptSocket);
WSACloseEvent(EventArray[Index - WSA_WAIT_EVENT_0]);
WSACleanup();
return 1;
}
//-----------------------------------------
// If data has been received, echo the received data
// from DataBuf back to the client
iResult =
WSASend(AcceptSocket, &DataBuf, 1, &RecvBytes, Flags, &AcceptOverlapped, NULL);
if (iResult != 0) {
wprintf(L"WSASend failed with error = %d\n", WSAGetLastError());
}
//-----------------------------------------
// Reset the changed flags and overlapped structure
Flags = 0;
ZeroMemory(&AcceptOverlapped, sizeof (WSAOVERLAPPED));
AcceptOverlapped.hEvent = EventArray[Index - WSA_WAIT_EVENT_0];
//-----------------------------------------
// Reset the data buffer
DataBuf.len = DATA_BUFSIZE;
DataBuf.buf = buffer;
}
closesocket(ListenSocket);
closesocket(AcceptSocket);
WSACleanup();
return 0;
}
Windows Phone 8: この関数は、Windows Phone 8 以降の Windows Phone ストアアプリでサポートされています。
Windows 8.1 および Windows Server 2012 R2: この関数は、Windows 8.1、Windows Server 2012 R2 以降の Windows ストアアプリでサポートされています。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での呼び出し定義
// 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_EVENTfunction 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)。const std = @import("std");
extern "ws2_32" fn WSAWaitForMultipleEvents(
cEvents: u32, // DWORD
lphEvents: ?*anyopaque, // HANDLE*
fWaitAll: i32, // BOOL
dwTimeout: u32, // DWORD
fAlertable: i32 // BOOL
) callconv(std.os.windows.WINAPI) u32;proc WSAWaitForMultipleEvents(
cEvents: uint32, # DWORD
lphEvents: pointer, # HANDLE*
fWaitAll: int32, # BOOL
dwTimeout: uint32, # DWORD
fAlertable: int32 # BOOL
): uint32 {.importc: "WSAWaitForMultipleEvents", stdcall, dynlib: "WS2_32.dll".}pragma(lib, "ws2_32");
extern(Windows)
uint WSAWaitForMultipleEvents(
uint cEvents, // DWORD
void* lphEvents, // HANDLE*
int fWaitAll, // BOOL
uint dwTimeout, // DWORD
int fAlertable // BOOL
);ccall((:WSAWaitForMultipleEvents, "WS2_32.dll"), stdcall, UInt32,
(UInt32, Ptr{Cvoid}, Int32, UInt32, Int32),
cEvents, lphEvents, fWaitAll, dwTimeout, fAlertable)
# cEvents : DWORD -> UInt32
# lphEvents : HANDLE* -> Ptr{Cvoid}
# fWaitAll : BOOL -> Int32
# dwTimeout : DWORD -> UInt32
# fAlertable : BOOL -> Int32
# stdcall は 32bit のみ意味を持つ(x64 では無視)。local ffi = require("ffi")
ffi.cdef[[
uint32_t WSAWaitForMultipleEvents(
uint32_t cEvents,
void* lphEvents,
int32_t fWaitAll,
uint32_t dwTimeout,
int32_t fAlertable);
]]
local ws2_32 = ffi.load("ws2_32")
-- ws2_32.WSAWaitForMultipleEvents(cEvents, lphEvents, fWaitAll, dwTimeout, fAlertable)
-- cEvents : DWORD
-- lphEvents : HANDLE*
-- fWaitAll : BOOL
-- dwTimeout : DWORD
-- fAlertable : BOOL
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。const koffi = require('koffi');
const lib = koffi.load('WS2_32.dll');
const WSAWaitForMultipleEvents = lib.func('__stdcall', 'WSAWaitForMultipleEvents', 'uint32_t', ['uint32_t', 'void *', 'int32_t', 'uint32_t', 'int32_t']);
// WSAWaitForMultipleEvents(cEvents, lphEvents, fWaitAll, dwTimeout, fAlertable)
// cEvents : DWORD -> 'uint32_t'
// lphEvents : HANDLE* -> 'void *'
// fWaitAll : BOOL -> 'int32_t'
// dwTimeout : DWORD -> 'uint32_t'
// fAlertable : BOOL -> 'int32_t'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。const lib = Deno.dlopen("WS2_32.dll", {
WSAWaitForMultipleEvents: { parameters: ["u32", "pointer", "i32", "u32", "i32"], result: "u32" },
});
// lib.symbols.WSAWaitForMultipleEvents(cEvents, lphEvents, fWaitAll, dwTimeout, fAlertable)
// cEvents : DWORD -> "u32"
// lphEvents : HANDLE* -> "pointer"
// fWaitAll : BOOL -> "i32"
// dwTimeout : DWORD -> "u32"
// fAlertable : BOOL -> "i32"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。<?php
$ffi = FFI::cdef(<<<C
uint32_t WSAWaitForMultipleEvents(
uint32_t cEvents,
void* lphEvents,
int32_t fWaitAll,
uint32_t dwTimeout,
int32_t fAlertable);
C, "WS2_32.dll");
// $ffi->WSAWaitForMultipleEvents(cEvents, lphEvents, fWaitAll, dwTimeout, fAlertable);
// cEvents : DWORD
// lphEvents : HANDLE*
// fWaitAll : BOOL
// dwTimeout : DWORD
// fAlertable : BOOL
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
// WINAPI(stdcall): x64 では呼出規約が統一されるため問題なし。x86 では __stdcall 対応のラッパが必要な場合あり。import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;
public interface Ws2_32 extends StdCallLibrary {
Ws2_32 INSTANCE = Native.load("ws2_32", Ws2_32.class);
int WSAWaitForMultipleEvents(
int cEvents, // DWORD
Pointer lphEvents, // HANDLE*
boolean fWaitAll, // BOOL
int dwTimeout, // DWORD
boolean fAlertable // BOOL
);
}@[Link("ws2_32")]
lib LibWS2_32
fun WSAWaitForMultipleEvents = WSAWaitForMultipleEvents(
cEvents : UInt32, # DWORD
lphEvents : Void*, # HANDLE*
fWaitAll : Int32, # BOOL
dwTimeout : UInt32, # DWORD
fAlertable : Int32 # BOOL
) : UInt32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef WSAWaitForMultipleEventsNative = Uint32 Function(Uint32, Pointer<Void>, Int32, Uint32, Int32);
typedef WSAWaitForMultipleEventsDart = int Function(int, Pointer<Void>, int, int, int);
final WSAWaitForMultipleEvents = DynamicLibrary.open('WS2_32.dll')
.lookupFunction<WSAWaitForMultipleEventsNative, WSAWaitForMultipleEventsDart>('WSAWaitForMultipleEvents');
// cEvents : DWORD -> Uint32
// lphEvents : HANDLE* -> Pointer<Void>
// fWaitAll : BOOL -> Int32
// dwTimeout : DWORD -> Uint32
// fAlertable : BOOL -> Int32
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。{$mode objfpc}{$H+}
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';import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import stdcall safe "WSAWaitForMultipleEvents"
c_WSAWaitForMultipleEvents :: Word32 -> Ptr () -> CInt -> Word32 -> CInt -> IO Word32
-- cEvents : DWORD -> Word32
-- lphEvents : HANDLE* -> Ptr ()
-- fWaitAll : BOOL -> CInt
-- dwTimeout : DWORD -> Word32
-- fAlertable : BOOL -> CInt
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。open Ctypes
open Foreign
let wsawaitformultipleevents =
foreign "WSAWaitForMultipleEvents"
(uint32_t @-> (ptr void) @-> int32_t @-> uint32_t @-> int32_t @-> returning uint32_t)
(* cEvents : DWORD -> uint32_t *)
(* lphEvents : HANDLE* -> (ptr void) *)
(* fWaitAll : BOOL -> int32_t *)
(* dwTimeout : DWORD -> uint32_t *)
(* fAlertable : BOOL -> int32_t *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)(cffi:define-foreign-library ws2_32 (t "WS2_32.dll"))
(cffi:use-foreign-library ws2_32)
(cffi:defcfun ("WSAWaitForMultipleEvents" wsawait-for-multiple-events :convention :stdcall) :uint32
(c-events :uint32) ; DWORD
(lph-events :pointer) ; HANDLE*
(f-wait-all :int32) ; BOOL
(dw-timeout :uint32) ; DWORD
(f-alertable :int32)) ; BOOL
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。use Win32::API;
my $WSAWaitForMultipleEvents = Win32::API::More->new('WS2_32',
'DWORD WSAWaitForMultipleEvents(DWORD cEvents, HANDLE lphEvents, BOOL fWaitAll, DWORD dwTimeout, BOOL fAlertable)');
# my $ret = $WSAWaitForMultipleEvents->Call($cEvents, $lphEvents, $fWaitAll, $dwTimeout, $fAlertable);
# cEvents : DWORD -> DWORD
# lphEvents : HANDLE* -> HANDLE
# fWaitAll : BOOL -> BOOL
# dwTimeout : DWORD -> DWORD
# fAlertable : BOOL -> BOOL
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。関連項目
- f WSACloseEvent — イベントオブジェクトハンドルを閉じて解放する。
- f WSACreateEvent — 新しいイベントオブジェクトを作成する。
- f WaitForMultipleObjectsEx — 警告可能モードで複数オブジェクトのシグナルを待機する。