ホーム › Media.MediaFoundation › MFP_EVENT_HEADER
MFP_EVENT_HEADER
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| eEventType | MFP_EVENT_TYPE | 4 | +0 | +0 | イベントの種類を、MFP_EVENT_TYPE 列挙型のメンバーとして指定します。 |
| hrEvent | HRESULT | 4 | +4 | +4 | イベントの原因となった操作のエラーコードまたは成功コードです。 |
| pMediaPlayer | IMFPMediaPlayer* | 8/4 | +8 | +8 | イベントを送信した MFPlay プレーヤーオブジェクトの IMFPMediaPlayer インターフェイスへのポインターです。 |
| eState | MFP_MEDIAPLAYER_STATE | 4 | +16 | +12 | MFPlay プレーヤーオブジェクトの新しい状態を、MFP_MEDIAPLAYER_STATE 列挙型のメンバーとして指定します。 |
| pPropertyStore | IPropertyStore* | 8/4 | +24 | +16 | プロパティストアオブジェクトの IPropertyStore インターフェイスへのポインターです。プロパティストアは、一部のイベントの種類において追加のイベントデータを保持するために使用されます。このメンバーは NULL の場合があります。 |
公式ドキュメント
[このページに関連する機能である MFPlay はレガシー機能です。MediaPlayer および IMFMediaEngine に置き換えられました。これらの機能は Windows 10 および Windows 11 向けに最適化されています。可能な場合は、新しいコードでは DirectShow ではなく MediaPlayer および IMFMediaEngine を使用することを Microsoft は強く推奨します。レガシー API を使用している既存のコードについても、可能であれば新しい API を使用するように書き換えることを Microsoft は推奨します。]
MFPlay のあらゆる種類のイベントに共通する情報を格納します。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// MFP_EVENT_HEADER (x64 32 / x86 20 バイト)
typedef struct MFP_EVENT_HEADER {
MFP_EVENT_TYPE eEventType;
HRESULT hrEvent;
IMFPMediaPlayer* pMediaPlayer;
MFP_MEDIAPLAYER_STATE eState;
IPropertyStore* pPropertyStore;
} MFP_EVENT_HEADER;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MFP_EVENT_HEADER
{
public int eEventType;
public int hrEvent;
public IntPtr pMediaPlayer;
public int eState;
public IntPtr pPropertyStore;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MFP_EVENT_HEADER
Public eEventType As Integer
Public hrEvent As Integer
Public pMediaPlayer As IntPtr
Public eState As Integer
Public pPropertyStore As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class MFP_EVENT_HEADER(ctypes.Structure):
_fields_ = [
("eEventType", ctypes.c_int),
("hrEvent", ctypes.c_int),
("pMediaPlayer", ctypes.c_void_p),
("eState", ctypes.c_int),
("pPropertyStore", ctypes.c_void_p),
]#[repr(C)]
pub struct MFP_EVENT_HEADER {
pub eEventType: i32,
pub hrEvent: i32,
pub pMediaPlayer: *mut core::ffi::c_void,
pub eState: i32,
pub pPropertyStore: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type MFP_EVENT_HEADER struct {
eEventType int32
hrEvent int32
pMediaPlayer uintptr
eState int32
pPropertyStore uintptr
}type
MFP_EVENT_HEADER = record
eEventType: Integer;
hrEvent: Integer;
pMediaPlayer: Pointer;
eState: Integer;
pPropertyStore: Pointer;
end;const MFP_EVENT_HEADER = extern struct {
eEventType: i32,
hrEvent: i32,
pMediaPlayer: ?*anyopaque,
eState: i32,
pPropertyStore: ?*anyopaque,
};type
MFP_EVENT_HEADER {.bycopy.} = object
eEventType: int32
hrEvent: int32
pMediaPlayer: pointer
eState: int32
pPropertyStore: pointerstruct MFP_EVENT_HEADER
{
int eEventType;
int hrEvent;
void* pMediaPlayer;
int eState;
void* pPropertyStore;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; MFP_EVENT_HEADER サイズ: 20 バイト(x86)
dim st, 5 ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; eEventType : MFP_EVENT_TYPE (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; hrEvent : HRESULT (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; pMediaPlayer : IMFPMediaPlayer* (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; eState : MFP_MEDIAPLAYER_STATE (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; pPropertyStore : IPropertyStore* (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MFP_EVENT_HEADER サイズ: 32 バイト(x64)
dim st, 8 ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; eEventType : MFP_EVENT_TYPE (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; hrEvent : HRESULT (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; pMediaPlayer : IMFPMediaPlayer* (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; eState : MFP_MEDIAPLAYER_STATE (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; pPropertyStore : IPropertyStore* (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global MFP_EVENT_HEADER
#field int eEventType
#field int hrEvent
#field intptr pMediaPlayer
#field int eState
#field intptr pPropertyStore
#endstruct
stdim st, MFP_EVENT_HEADER ; NSTRUCT 変数を確保
st->eEventType = 100
mes "eEventType=" + st->eEventType