ホーム › System.Threading › SetThreadGroupAffinity
SetThreadGroupAffinity
関数スレッドのグループアフィニティを設定する。
シグネチャ
// KERNEL32.dll
#include <windows.h>
BOOL SetThreadGroupAffinity(
HANDLE hThread,
const GROUP_AFFINITY* GroupAffinity,
GROUP_AFFINITY* PreviousGroupAffinity // optional
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| hThread | HANDLE | in |
| GroupAffinity | GROUP_AFFINITY* | in |
| PreviousGroupAffinity | GROUP_AFFINITY* | outoptional |
戻り値の型: BOOL
各言語での呼び出し定義
// KERNEL32.dll
#include <windows.h>
BOOL SetThreadGroupAffinity(
HANDLE hThread,
const GROUP_AFFINITY* GroupAffinity,
GROUP_AFFINITY* PreviousGroupAffinity // optional
);[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("KERNEL32.dll", ExactSpelling = true)]
static extern bool SetThreadGroupAffinity(
IntPtr hThread, // HANDLE
IntPtr GroupAffinity, // GROUP_AFFINITY*
IntPtr PreviousGroupAffinity // GROUP_AFFINITY* optional, out
);<DllImport("KERNEL32.dll", ExactSpelling:=True)>
Public Shared Function SetThreadGroupAffinity(
hThread As IntPtr, ' HANDLE
GroupAffinity As IntPtr, ' GROUP_AFFINITY*
PreviousGroupAffinity As IntPtr ' GROUP_AFFINITY* optional, out
) As Boolean
End Function' hThread : HANDLE
' GroupAffinity : GROUP_AFFINITY*
' PreviousGroupAffinity : GROUP_AFFINITY* optional, out
Declare PtrSafe Function SetThreadGroupAffinity Lib "kernel32" ( _
ByVal hThread As LongPtr, _
ByVal GroupAffinity As LongPtr, _
ByVal PreviousGroupAffinity As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
SetThreadGroupAffinity = ctypes.windll.kernel32.SetThreadGroupAffinity
SetThreadGroupAffinity.restype = wintypes.BOOL
SetThreadGroupAffinity.argtypes = [
wintypes.HANDLE, # hThread : HANDLE
ctypes.c_void_p, # GroupAffinity : GROUP_AFFINITY*
ctypes.c_void_p, # PreviousGroupAffinity : GROUP_AFFINITY* optional, out
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('KERNEL32.dll')
SetThreadGroupAffinity = Fiddle::Function.new(
lib['SetThreadGroupAffinity'],
[
Fiddle::TYPE_VOIDP, # hThread : HANDLE
Fiddle::TYPE_VOIDP, # GroupAffinity : GROUP_AFFINITY*
Fiddle::TYPE_VOIDP, # PreviousGroupAffinity : GROUP_AFFINITY* optional, out
],
Fiddle::TYPE_INT)#[link(name = "kernel32")]
extern "system" {
fn SetThreadGroupAffinity(
hThread: *mut core::ffi::c_void, // HANDLE
GroupAffinity: *const GROUP_AFFINITY, // GROUP_AFFINITY*
PreviousGroupAffinity: *mut GROUP_AFFINITY // GROUP_AFFINITY* optional, out
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("KERNEL32.dll")]
public static extern bool SetThreadGroupAffinity(IntPtr hThread, IntPtr GroupAffinity, IntPtr PreviousGroupAffinity);
"@
$api = Add-Type -MemberDefinition $sig -Name 'KERNEL32_SetThreadGroupAffinity' -Namespace Win32 -PassThru
# $api::SetThreadGroupAffinity(hThread, GroupAffinity, PreviousGroupAffinity)#uselib "KERNEL32.dll"
#func global SetThreadGroupAffinity "SetThreadGroupAffinity" sptr, sptr, sptr
; SetThreadGroupAffinity hThread, varptr(GroupAffinity), varptr(PreviousGroupAffinity) ; 戻り値は stat
; hThread : HANDLE -> "sptr"
; GroupAffinity : GROUP_AFFINITY* -> "sptr"
; PreviousGroupAffinity : GROUP_AFFINITY* optional, out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "KERNEL32.dll" #cfunc global SetThreadGroupAffinity "SetThreadGroupAffinity" sptr, var, var ; res = SetThreadGroupAffinity(hThread, GroupAffinity, PreviousGroupAffinity) ; hThread : HANDLE -> "sptr" ; GroupAffinity : GROUP_AFFINITY* -> "var" ; PreviousGroupAffinity : GROUP_AFFINITY* optional, out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "KERNEL32.dll" #cfunc global SetThreadGroupAffinity "SetThreadGroupAffinity" sptr, sptr, sptr ; res = SetThreadGroupAffinity(hThread, varptr(GroupAffinity), varptr(PreviousGroupAffinity)) ; hThread : HANDLE -> "sptr" ; GroupAffinity : GROUP_AFFINITY* -> "sptr" ; PreviousGroupAffinity : GROUP_AFFINITY* optional, out -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; BOOL SetThreadGroupAffinity(HANDLE hThread, GROUP_AFFINITY* GroupAffinity, GROUP_AFFINITY* PreviousGroupAffinity) #uselib "KERNEL32.dll" #cfunc global SetThreadGroupAffinity "SetThreadGroupAffinity" intptr, var, var ; res = SetThreadGroupAffinity(hThread, GroupAffinity, PreviousGroupAffinity) ; hThread : HANDLE -> "intptr" ; GroupAffinity : GROUP_AFFINITY* -> "var" ; PreviousGroupAffinity : GROUP_AFFINITY* optional, out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; BOOL SetThreadGroupAffinity(HANDLE hThread, GROUP_AFFINITY* GroupAffinity, GROUP_AFFINITY* PreviousGroupAffinity) #uselib "KERNEL32.dll" #cfunc global SetThreadGroupAffinity "SetThreadGroupAffinity" intptr, intptr, intptr ; res = SetThreadGroupAffinity(hThread, varptr(GroupAffinity), varptr(PreviousGroupAffinity)) ; hThread : HANDLE -> "intptr" ; GroupAffinity : GROUP_AFFINITY* -> "intptr" ; PreviousGroupAffinity : GROUP_AFFINITY* optional, out -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
kernel32 = windows.NewLazySystemDLL("KERNEL32.dll")
procSetThreadGroupAffinity = kernel32.NewProc("SetThreadGroupAffinity")
)
// hThread (HANDLE), GroupAffinity (GROUP_AFFINITY*), PreviousGroupAffinity (GROUP_AFFINITY* optional, out)
r1, _, err := procSetThreadGroupAffinity.Call(
uintptr(hThread),
uintptr(GroupAffinity),
uintptr(PreviousGroupAffinity),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // BOOLfunction SetThreadGroupAffinity(
hThread: THandle; // HANDLE
GroupAffinity: Pointer; // GROUP_AFFINITY*
PreviousGroupAffinity: Pointer // GROUP_AFFINITY* optional, out
): BOOL; stdcall;
external 'KERNEL32.dll' name 'SetThreadGroupAffinity';result := DllCall("KERNEL32\SetThreadGroupAffinity"
, "Ptr", hThread ; HANDLE
, "Ptr", GroupAffinity ; GROUP_AFFINITY*
, "Ptr", PreviousGroupAffinity ; GROUP_AFFINITY* optional, out
, "Int") ; return: BOOL●SetThreadGroupAffinity(hThread, GroupAffinity, PreviousGroupAffinity) = DLL("KERNEL32.dll", "bool SetThreadGroupAffinity(void*, void*, void*)")
# 呼び出し: SetThreadGroupAffinity(hThread, GroupAffinity, PreviousGroupAffinity)
# hThread : HANDLE -> "void*"
# GroupAffinity : GROUP_AFFINITY* -> "void*"
# PreviousGroupAffinity : GROUP_AFFINITY* optional, out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。