Win32 API 日本語リファレンス
ホームMedia.MediaFoundation › MFP_EVENT_HEADER

MFP_EVENT_HEADER

構造体
サイズx64: 32 バイト / x86: 20 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
eEventTypeMFP_EVENT_TYPE4+0+0イベントの種類を、MFP_EVENT_TYPE 列挙型のメンバーとして指定します。
hrEventHRESULT4+4+4イベントの原因となった操作のエラーコードまたは成功コードです。
pMediaPlayerIMFPMediaPlayer*8/4+8+8イベントを送信した MFPlay プレーヤーオブジェクトの IMFPMediaPlayer インターフェイスへのポインターです。
eStateMFP_MEDIAPLAYER_STATE4+16+12MFPlay プレーヤーオブジェクトの新しい状態を、MFP_MEDIAPLAYER_STATE 列挙型のメンバーとして指定します。
pPropertyStoreIPropertyStore*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)

各言語での定義

#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 Structure
import 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: pointer
struct 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