lineMonitorMedia
関数シグネチャ
// TAPI32.dll
#include <windows.h>
INT lineMonitorMedia(
DWORD hCall,
DWORD dwMediaModes
);パラメーター
| 名前 | 型 | 方向 | 説明 |
|---|---|---|---|
| hCall | DWORD | in | 呼び出しへのハンドル。hCall の呼び出し状態は、idle 以外の任意の状態を指定できます。 |
| dwMediaModes | DWORD | in | 監視するメディアの種類。このパラメーターが 0 の場合、すべてのメディアの種類の検出が取り消されます。このパラメーターには、 LINEMEDIAMODE_ 定数を 1 つ以上使用します。 |
戻り値の型: INT
公式ドキュメント
lineMonitorMedia 関数は、指定された呼び出しでのメディアの種類 (モード) の検出を有効または無効にします。メディアの種類が検出されると、アプリケーションにメッセージが送信されます。詳細については、ITLegacyCallMediaControl::MonitorMedia を参照してください。
戻り値
要求が成功した場合は 0 を、エラーが発生した場合は負のエラー番号を返します。返される可能性のある値は次のとおりです。
LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_INVALMEDIAMODE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。
解説(Remarks)
lineOpen で指定されるメディアの種類は、新しい着信呼び出しを適切なアプリケーションに引き渡す目的で、サービスプロバイダーによるこれらのメディアの種類の検出を有効にすることだけに関係します。これらは、以前の lineMonitorMedia の呼び出しによって期待されるメディアモード通知メッセージには影響しません。
この関数は、メディアの種類の監視が正しく開始された時点で成功と見なされ、メディアの種類の監視が終了した時点ではありません。特定のメディアの種類に対するメディア監視は、dwMediaModes パラメーターを 0 に設定して lineMonitorMedia を呼び出して明示的に無効にするか、呼び出しが idle に遷移するか、アプリケーションがその呼び出しの呼び出しハンドルを解放するまで有効なままです。 lineMonitorMedia 関数は、主にイベント報告のメカニズムです。 LINECALLINFO に示される呼び出しのメディアの種類 (モード) は、サービスプロバイダーによるメディアの種類の検出による影響を受けません。呼び出しのメディアの種類を変更できるのは、制御側のアプリケーションだけです。
サービスプロバイダーが実行する既定のメディア監視は、 lineOpen で指定されたすべてのメディアの種類の和集合に対応します。
この関数は任意の呼び出し状態で呼び出すことができますが、通常、呼び出しのメディアの種類を検出できるのは、呼び出しが特定の呼び出し状態にある間だけです。これらの状態はデバイス固有である場合があります。たとえば ISDN では、メディアストリームが存在する前にメッセージがメディアストリームのメディアの種類を示すことができます。同様に、特徴的な呼び出し音や呼び出し先の識別子情報を使用して、呼び出しのメディアの種類を識別できます。それ以外の場合、サービスプロバイダーがメディアストリームをフィルター処理して呼び出しのメディアの種類を判別できるようにするために、呼び出しに応答する (呼び出しが connected 状態になる) 必要が生じることがあります。呼び出しのメディアストリームのフィルター処理は計算のオーバーヘッドを伴うため、アプリケーションは必要のないときにはメディア監視を無効にする必要があります。既定では、呼び出しのメディアの種類によってその呼び出しを処理すべきアプリケーションが選択されるため、新しい着信呼び出しに対してはメディア監視が有効になっています。
音声メディアの種類を扱う発信アプリケーションでは、呼び出しの相手側にいるのが誰か、または何かを区別するために、呼び出しの無音 (トーン) を監視したい場合があります。たとえば、自宅にいる人は短い「もしもし」だけで呼び出しに応答することがあります。オフィスにいる人は、氏名や会社名を伝えるより長い挨拶をすることがあります。留守番電話では、通常さらに長い応答メッセージになります。
lineMonitorMedia によって有効になるメディアモードの検出は、呼び出しのメディアストリームに対する読み取り専用の操作として実装されているため、破壊的な影響はありません。
会議通話でのメディアの監視は、hConfCall パラメーターにのみ適用され、個々の参加中の呼び出しには適用されません。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での呼び出し定義
// TAPI32.dll
#include <windows.h>
INT lineMonitorMedia(
DWORD hCall,
DWORD dwMediaModes
);[DllImport("TAPI32.dll", ExactSpelling = true)]
static extern int lineMonitorMedia(
uint hCall, // DWORD
uint dwMediaModes // DWORD
);<DllImport("TAPI32.dll", ExactSpelling:=True)>
Public Shared Function lineMonitorMedia(
hCall As UInteger, ' DWORD
dwMediaModes As UInteger ' DWORD
) As Integer
End Function' hCall : DWORD
' dwMediaModes : DWORD
Declare PtrSafe Function lineMonitorMedia Lib "tapi32" ( _
ByVal hCall As Long, _
ByVal dwMediaModes As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
lineMonitorMedia = ctypes.windll.tapi32.lineMonitorMedia
lineMonitorMedia.restype = ctypes.c_int
lineMonitorMedia.argtypes = [
wintypes.DWORD, # hCall : DWORD
wintypes.DWORD, # dwMediaModes : DWORD
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('TAPI32.dll')
lineMonitorMedia = Fiddle::Function.new(
lib['lineMonitorMedia'],
[
-Fiddle::TYPE_INT, # hCall : DWORD
-Fiddle::TYPE_INT, # dwMediaModes : DWORD
],
Fiddle::TYPE_INT)#[link(name = "tapi32")]
extern "system" {
fn lineMonitorMedia(
hCall: u32, // DWORD
dwMediaModes: u32 // DWORD
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("TAPI32.dll")]
public static extern int lineMonitorMedia(uint hCall, uint dwMediaModes);
"@
$api = Add-Type -MemberDefinition $sig -Name 'TAPI32_lineMonitorMedia' -Namespace Win32 -PassThru
# $api::lineMonitorMedia(hCall, dwMediaModes)#uselib "TAPI32.dll"
#func global lineMonitorMedia "lineMonitorMedia" sptr, sptr
; lineMonitorMedia hCall, dwMediaModes ; 戻り値は stat
; hCall : DWORD -> "sptr"
; dwMediaModes : DWORD -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。#uselib "TAPI32.dll"
#cfunc global lineMonitorMedia "lineMonitorMedia" int, int
; res = lineMonitorMedia(hCall, dwMediaModes)
; hCall : DWORD -> "int"
; dwMediaModes : DWORD -> "int"; INT lineMonitorMedia(DWORD hCall, DWORD dwMediaModes)
#uselib "TAPI32.dll"
#cfunc global lineMonitorMedia "lineMonitorMedia" int, int
; res = lineMonitorMedia(hCall, dwMediaModes)
; hCall : DWORD -> "int"
; dwMediaModes : DWORD -> "int"import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
tapi32 = windows.NewLazySystemDLL("TAPI32.dll")
proclineMonitorMedia = tapi32.NewProc("lineMonitorMedia")
)
// hCall (DWORD), dwMediaModes (DWORD)
r1, _, err := proclineMonitorMedia.Call(
uintptr(hCall),
uintptr(dwMediaModes),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // INTfunction lineMonitorMedia(
hCall: DWORD; // DWORD
dwMediaModes: DWORD // DWORD
): Integer; stdcall;
external 'TAPI32.dll' name 'lineMonitorMedia';result := DllCall("TAPI32\lineMonitorMedia"
, "UInt", hCall ; DWORD
, "UInt", dwMediaModes ; DWORD
, "Int") ; return: INT●lineMonitorMedia(hCall, dwMediaModes) = DLL("TAPI32.dll", "int lineMonitorMedia(dword, dword)")
# 呼び出し: lineMonitorMedia(hCall, dwMediaModes)
# hCall : DWORD -> "dword"
# dwMediaModes : DWORD -> "dword"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。const std = @import("std");
extern "tapi32" fn lineMonitorMedia(
hCall: u32, // DWORD
dwMediaModes: u32 // DWORD
) callconv(std.os.windows.WINAPI) i32;proc lineMonitorMedia(
hCall: uint32, # DWORD
dwMediaModes: uint32 # DWORD
): int32 {.importc: "lineMonitorMedia", stdcall, dynlib: "TAPI32.dll".}pragma(lib, "tapi32");
extern(Windows)
int lineMonitorMedia(
uint hCall, // DWORD
uint dwMediaModes // DWORD
);ccall((:lineMonitorMedia, "TAPI32.dll"), stdcall, Int32,
(UInt32, UInt32),
hCall, dwMediaModes)
# hCall : DWORD -> UInt32
# dwMediaModes : DWORD -> UInt32
# stdcall は 32bit のみ意味を持つ(x64 では無視)。local ffi = require("ffi")
ffi.cdef[[
int32_t lineMonitorMedia(
uint32_t hCall,
uint32_t dwMediaModes);
]]
local tapi32 = ffi.load("tapi32")
-- tapi32.lineMonitorMedia(hCall, dwMediaModes)
-- hCall : DWORD
-- dwMediaModes : DWORD
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。const koffi = require('koffi');
const lib = koffi.load('TAPI32.dll');
const lineMonitorMedia = lib.func('__stdcall', 'lineMonitorMedia', 'int32_t', ['uint32_t', 'uint32_t']);
// lineMonitorMedia(hCall, dwMediaModes)
// hCall : DWORD -> 'uint32_t'
// dwMediaModes : DWORD -> 'uint32_t'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。const lib = Deno.dlopen("TAPI32.dll", {
lineMonitorMedia: { parameters: ["u32", "u32"], result: "i32" },
});
// lib.symbols.lineMonitorMedia(hCall, dwMediaModes)
// hCall : DWORD -> "u32"
// dwMediaModes : DWORD -> "u32"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。<?php
$ffi = FFI::cdef(<<<C
int32_t lineMonitorMedia(
uint32_t hCall,
uint32_t dwMediaModes);
C, "TAPI32.dll");
// $ffi->lineMonitorMedia(hCall, dwMediaModes);
// hCall : DWORD
// dwMediaModes : DWORD
// 構造体/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 Tapi32 extends StdCallLibrary {
Tapi32 INSTANCE = Native.load("tapi32", Tapi32.class);
int lineMonitorMedia(
int hCall, // DWORD
int dwMediaModes // DWORD
);
}@[Link("tapi32")]
lib LibTAPI32
fun lineMonitorMedia = lineMonitorMedia(
hCall : UInt32, # DWORD
dwMediaModes : UInt32 # DWORD
) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef lineMonitorMediaNative = Int32 Function(Uint32, Uint32);
typedef lineMonitorMediaDart = int Function(int, int);
final lineMonitorMedia = DynamicLibrary.open('TAPI32.dll')
.lookupFunction<lineMonitorMediaNative, lineMonitorMediaDart>('lineMonitorMedia');
// hCall : DWORD -> Uint32
// dwMediaModes : DWORD -> Uint32
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。{$mode objfpc}{$H+}
function lineMonitorMedia(
hCall: DWORD; // DWORD
dwMediaModes: DWORD // DWORD
): Integer; stdcall;
external 'TAPI32.dll' name 'lineMonitorMedia';import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import stdcall safe "lineMonitorMedia"
c_lineMonitorMedia :: Word32 -> Word32 -> IO Int32
-- hCall : DWORD -> Word32
-- dwMediaModes : DWORD -> Word32
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。open Ctypes
open Foreign
let linemonitormedia =
foreign "lineMonitorMedia"
(uint32_t @-> uint32_t @-> returning int32_t)
(* hCall : DWORD -> uint32_t *)
(* dwMediaModes : DWORD -> uint32_t *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)(cffi:define-foreign-library tapi32 (t "TAPI32.dll"))
(cffi:use-foreign-library tapi32)
(cffi:defcfun ("lineMonitorMedia" line-monitor-media :convention :stdcall) :int32
(h-call :uint32) ; DWORD
(dw-media-modes :uint32)) ; DWORD
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。use Win32::API;
my $lineMonitorMedia = Win32::API::More->new('TAPI32',
'int lineMonitorMedia(DWORD hCall, DWORD dwMediaModes)');
# my $ret = $lineMonitorMedia->Call($hCall, $dwMediaModes);
# hCall : DWORD -> DWORD
# dwMediaModes : DWORD -> DWORD
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。関連項目
- s LINECALLINFO
- f lineOpenW — 回線デバイスを開いてハンドルを取得する(Unicode版)。