WM_READER_CLIENTINFO
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| cbSize | DWORD | 4 | +0 | +0 | 構造体のサイズ (バイト単位)。 |
| wszLang | LPWSTR | 8/4 | +8 | +4 | 2 文字または 3 文字の言語コード。 |
| wszBrowserUserAgent | LPWSTR | 8/4 | +16 | +8 | ブラウザーのユーザー エージェント文字列。 |
| wszBrowserWebPage | LPWSTR | 8/4 | +24 | +12 | プラグインを含む Web ページ。 |
| qwReserved | ULONGLONG | 8 | +32 | +16 | 予約済みです。 |
| pReserved | LPARAM* | 8/4 | +40 | +24 | 未使用です。解説を参照してください。 |
| wszHostExe | LPWSTR | 8/4 | +48 | +28 | ホスト アプリケーションの .exe ファイル。たとえば Iexplore.exe です。 |
| qwHostVersion | ULONGLONG | 8 | +56 | +32 | ホスト アプリケーションのバージョン番号。値は 4 つの符号なし WORD 値を 64 ビット整数にパックしたものです。クライアント情報がログに記録される際、各 WORD 値はアンパックされて 10 進数表記に変換されます。たとえば値が 0x0001000200030004 の場合、バージョン番号は "1.2.3.4" としてログに記録されます。 |
| wszPlayerUserAgent | LPWSTR | 8/4 | +64 | +40 | プレーヤー アプリケーションを識別する文字列。たとえば "WMPlayer/9.0.0.0" は Windows Media Player のバージョン 9 を示します。 |
公式ドキュメント
[このページに関連する機能である Windows Media Format 11 SDK はレガシー機能です。この機能は Source Reader および Sink Writer に置き換えられました。Source Reader と Sink Writer は Windows 10 および Windows 11 向けに最適化されています。Microsoft は、可能な場合は新しいコードで Windows Media Format 11 SDK ではなく Source Reader と Sink Writer を使用することを強く推奨します。また、レガシー API を使用している既存のコードについても、可能であれば新しい API を使用するように書き換えることを推奨します。]
WM_READER_CLIENTINFO 構造体は、メディア ストリームにアクセスするクライアント リーダー (プレーヤー) を記述します。
解説(Remarks)
この SDK の以前のバージョンでは、pReserved メンバーは wszHostUniquePID という名前でした。アプリケーションはこのメンバーを使用して、サーバーに送信する ID を指定していました。現在のバージョンでは、リーダー オブジェクトが ID 用の GUID を自動的に生成するため、この構造体メンバーは廃止されています。以前のバージョンの SDK とのバイナリ互換性を確保するためにのみ存在します。
リーダー オブジェクトが生成する GUID は、特定のコンピューター上の一意のユーザーを表します。リーダー オブジェクトはこの値をレジストリに格納します。レジストリ エントリが存在しない場合は、SDK が動的に作成します。詳細については、IWMReaderAdvanced2::SetLogClientID を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// WM_READER_CLIENTINFO (x64 72 / x86 48 バイト)
typedef struct WM_READER_CLIENTINFO {
DWORD cbSize;
LPWSTR wszLang;
LPWSTR wszBrowserUserAgent;
LPWSTR wszBrowserWebPage;
ULONGLONG qwReserved;
LPARAM* pReserved;
LPWSTR wszHostExe;
ULONGLONG qwHostVersion;
LPWSTR wszPlayerUserAgent;
} WM_READER_CLIENTINFO;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct WM_READER_CLIENTINFO
{
public uint cbSize;
public IntPtr wszLang;
public IntPtr wszBrowserUserAgent;
public IntPtr wszBrowserWebPage;
public ulong qwReserved;
public IntPtr pReserved;
public IntPtr wszHostExe;
public ulong qwHostVersion;
public IntPtr wszPlayerUserAgent;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure WM_READER_CLIENTINFO
Public cbSize As UInteger
Public wszLang As IntPtr
Public wszBrowserUserAgent As IntPtr
Public wszBrowserWebPage As IntPtr
Public qwReserved As ULong
Public pReserved As IntPtr
Public wszHostExe As IntPtr
Public qwHostVersion As ULong
Public wszPlayerUserAgent As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class WM_READER_CLIENTINFO(ctypes.Structure):
_fields_ = [
("cbSize", wintypes.DWORD),
("wszLang", ctypes.c_void_p),
("wszBrowserUserAgent", ctypes.c_void_p),
("wszBrowserWebPage", ctypes.c_void_p),
("qwReserved", ctypes.c_ulonglong),
("pReserved", ctypes.c_void_p),
("wszHostExe", ctypes.c_void_p),
("qwHostVersion", ctypes.c_ulonglong),
("wszPlayerUserAgent", ctypes.c_void_p),
]#[repr(C)]
pub struct WM_READER_CLIENTINFO {
pub cbSize: u32,
pub wszLang: *mut core::ffi::c_void,
pub wszBrowserUserAgent: *mut core::ffi::c_void,
pub wszBrowserWebPage: *mut core::ffi::c_void,
pub qwReserved: u64,
pub pReserved: *mut core::ffi::c_void,
pub wszHostExe: *mut core::ffi::c_void,
pub qwHostVersion: u64,
pub wszPlayerUserAgent: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type WM_READER_CLIENTINFO struct {
cbSize uint32
wszLang uintptr
wszBrowserUserAgent uintptr
wszBrowserWebPage uintptr
qwReserved uint64
pReserved uintptr
wszHostExe uintptr
qwHostVersion uint64
wszPlayerUserAgent uintptr
}type
WM_READER_CLIENTINFO = record
cbSize: DWORD;
wszLang: Pointer;
wszBrowserUserAgent: Pointer;
wszBrowserWebPage: Pointer;
qwReserved: UInt64;
pReserved: Pointer;
wszHostExe: Pointer;
qwHostVersion: UInt64;
wszPlayerUserAgent: Pointer;
end;const WM_READER_CLIENTINFO = extern struct {
cbSize: u32,
wszLang: ?*anyopaque,
wszBrowserUserAgent: ?*anyopaque,
wszBrowserWebPage: ?*anyopaque,
qwReserved: u64,
pReserved: ?*anyopaque,
wszHostExe: ?*anyopaque,
qwHostVersion: u64,
wszPlayerUserAgent: ?*anyopaque,
};type
WM_READER_CLIENTINFO {.bycopy.} = object
cbSize: uint32
wszLang: pointer
wszBrowserUserAgent: pointer
wszBrowserWebPage: pointer
qwReserved: uint64
pReserved: pointer
wszHostExe: pointer
qwHostVersion: uint64
wszPlayerUserAgent: pointerstruct WM_READER_CLIENTINFO
{
uint cbSize;
void* wszLang;
void* wszBrowserUserAgent;
void* wszBrowserWebPage;
ulong qwReserved;
void* pReserved;
void* wszHostExe;
ulong qwHostVersion;
void* wszPlayerUserAgent;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; WM_READER_CLIENTINFO サイズ: 48 バイト(x86)
dim st, 12 ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; wszLang : LPWSTR (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; wszBrowserUserAgent : LPWSTR (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; wszBrowserWebPage : LPWSTR (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; qwReserved : ULONGLONG (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; pReserved : LPARAM* (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; wszHostExe : LPWSTR (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; qwHostVersion : ULONGLONG (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; wszPlayerUserAgent : LPWSTR (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; WM_READER_CLIENTINFO サイズ: 72 バイト(x64)
dim st, 18 ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; wszLang : LPWSTR (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; wszBrowserUserAgent : LPWSTR (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; wszBrowserWebPage : LPWSTR (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; qwReserved : ULONGLONG (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; pReserved : LPARAM* (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; wszHostExe : LPWSTR (+48, 8byte) qpoke st,48,値 / qpeek(st,48) ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; qwHostVersion : ULONGLONG (+56, 8byte) qpoke st,56,値 / qpeek(st,56) ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; wszPlayerUserAgent : LPWSTR (+64, 8byte) qpoke st,64,値 / qpeek(st,64) ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global WM_READER_CLIENTINFO
#field int cbSize
#field intptr wszLang
#field intptr wszBrowserUserAgent
#field intptr wszBrowserWebPage
#field int64 qwReserved
#field intptr pReserved
#field intptr wszHostExe
#field int64 qwHostVersion
#field intptr wszPlayerUserAgent
#endstruct
stdim st, WM_READER_CLIENTINFO ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize