AM_SAMPLE2_PROPERTIES
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| cbData | DWORD | 4 | +0 | +0 | プロパティデータの長さ (バイト単位)。この構造体メンバーは拡張性のために用意されています。 | ||||||||||||||||||||||
| dwTypeSpecificFlags | DWORD | 4 | +4 | +4 | 型固有のフラグです。フラグはメディアタイプごとに個別に定義されます。既定値は AM_VIDEO_FLAG_INTERLEAVED_FRAME (0) です。次のフラグはビデオストリームに使用されます。これらはヘッダーファイル dvdmedia.h で定義されています。
その他のフラグも定義されていますが、現在は使用されていません。dvdmedia.h を参照してください。 | ||||||||||||||||||||||
| dwSampleFlags | DWORD | 4 | +8 | +8 | AM_SAMPLE_PROPERTY_FLAGS 列挙データ型のフラグのビット単位の組み合わせです。未定義のビットは予約済みであり、0 でなければなりません。 | ||||||||||||||||||||||
| lActual | INT | 4 | +12 | +12 | バッファー内の有効なデータの長さです。 | ||||||||||||||||||||||
| tStart | LONGLONG | 8 | +16 | +16 | 開始時刻です (有効な場合)。このメンバーが有効かどうかは dwSampleFlags メンバーで指定されます。 | ||||||||||||||||||||||
| tStop | LONGLONG | 8 | +24 | +24 | 停止時刻です (有効な場合)。このメンバーが有効かどうかは dwSampleFlags メンバーで指定されます。 | ||||||||||||||||||||||
| dwStreamId | DWORD | 4 | +32 | +32 | ストリーム識別子です。値が AM_STREAM_MEDIA の場合、ストリームにはメディアデータが含まれます。値が AM_STREAM_CONTROL の場合、ストリームには制御情報が含まれます。アプリケーションは、独自の用途のために 0x80000000 以上の値を定義できます。(AM_SAMPLE_PROPERTY_FLAGS を参照してください。) | ||||||||||||||||||||||
| pMediaType | AM_MEDIA_TYPE* | 8/4 | +40 | +36 | フォーマットが変更された場合に、メディアタイプを指定する AM_MEDIA_TYPE 構造体へのポインターです。フォーマットが変更されていない場合、このメンバーは NULL です。 | ||||||||||||||||||||||
| pbBuffer | BYTE* | 8/4 | +48 | +40 | サンプルバッファーへのポインターです。 | ||||||||||||||||||||||
| cbBuffer | INT | 4 | +56 | +44 | サンプルバッファーのサイズ (バイト単位)。 |
公式ドキュメント
[このページに関連する機能である DirectShow はレガシー機能です。この機能は MediaPlayer、IMFMediaEngine、および Audio/Video Capture in Media Foundation に置き換えられました。これらの機能は Windows 10 および Windows 11 向けに最適化されています。Microsoft は、可能な場合は新しいコードで DirectShow ではなく MediaPlayer、IMFMediaEngine、Audio/Video Capture in Media Foundation を使用することを強く推奨します。レガシー API を使用している既存のコードについても、可能であれば新しい API を使用するように書き直すことを推奨します。]
AM_SAMPLE2_PROPERTIES 構造体は、メディアサンプルのプロパティを記述します。IMediaSample2 インターフェイスはこの構造体を使用します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// AM_SAMPLE2_PROPERTIES (x64 64 / x86 48 バイト)
typedef struct AM_SAMPLE2_PROPERTIES {
DWORD cbData;
DWORD dwTypeSpecificFlags;
DWORD dwSampleFlags;
INT lActual;
LONGLONG tStart;
LONGLONG tStop;
DWORD dwStreamId;
AM_MEDIA_TYPE* pMediaType;
BYTE* pbBuffer;
INT cbBuffer;
} AM_SAMPLE2_PROPERTIES;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct AM_SAMPLE2_PROPERTIES
{
public uint cbData;
public uint dwTypeSpecificFlags;
public uint dwSampleFlags;
public int lActual;
public long tStart;
public long tStop;
public uint dwStreamId;
public IntPtr pMediaType;
public IntPtr pbBuffer;
public int cbBuffer;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure AM_SAMPLE2_PROPERTIES
Public cbData As UInteger
Public dwTypeSpecificFlags As UInteger
Public dwSampleFlags As UInteger
Public lActual As Integer
Public tStart As Long
Public tStop As Long
Public dwStreamId As UInteger
Public pMediaType As IntPtr
Public pbBuffer As IntPtr
Public cbBuffer As Integer
End Structureimport ctypes
from ctypes import wintypes
class AM_SAMPLE2_PROPERTIES(ctypes.Structure):
_fields_ = [
("cbData", wintypes.DWORD),
("dwTypeSpecificFlags", wintypes.DWORD),
("dwSampleFlags", wintypes.DWORD),
("lActual", ctypes.c_int),
("tStart", ctypes.c_longlong),
("tStop", ctypes.c_longlong),
("dwStreamId", wintypes.DWORD),
("pMediaType", ctypes.c_void_p),
("pbBuffer", ctypes.c_void_p),
("cbBuffer", ctypes.c_int),
]#[repr(C)]
pub struct AM_SAMPLE2_PROPERTIES {
pub cbData: u32,
pub dwTypeSpecificFlags: u32,
pub dwSampleFlags: u32,
pub lActual: i32,
pub tStart: i64,
pub tStop: i64,
pub dwStreamId: u32,
pub pMediaType: *mut core::ffi::c_void,
pub pbBuffer: *mut core::ffi::c_void,
pub cbBuffer: i32,
}import "golang.org/x/sys/windows"
type AM_SAMPLE2_PROPERTIES struct {
cbData uint32
dwTypeSpecificFlags uint32
dwSampleFlags uint32
lActual int32
tStart int64
tStop int64
dwStreamId uint32
pMediaType uintptr
pbBuffer uintptr
cbBuffer int32
}type
AM_SAMPLE2_PROPERTIES = record
cbData: DWORD;
dwTypeSpecificFlags: DWORD;
dwSampleFlags: DWORD;
lActual: Integer;
tStart: Int64;
tStop: Int64;
dwStreamId: DWORD;
pMediaType: Pointer;
pbBuffer: Pointer;
cbBuffer: Integer;
end;const AM_SAMPLE2_PROPERTIES = extern struct {
cbData: u32,
dwTypeSpecificFlags: u32,
dwSampleFlags: u32,
lActual: i32,
tStart: i64,
tStop: i64,
dwStreamId: u32,
pMediaType: ?*anyopaque,
pbBuffer: ?*anyopaque,
cbBuffer: i32,
};type
AM_SAMPLE2_PROPERTIES {.bycopy.} = object
cbData: uint32
dwTypeSpecificFlags: uint32
dwSampleFlags: uint32
lActual: int32
tStart: int64
tStop: int64
dwStreamId: uint32
pMediaType: pointer
pbBuffer: pointer
cbBuffer: int32struct AM_SAMPLE2_PROPERTIES
{
uint cbData;
uint dwTypeSpecificFlags;
uint dwSampleFlags;
int lActual;
long tStart;
long tStop;
uint dwStreamId;
void* pMediaType;
void* pbBuffer;
int cbBuffer;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; AM_SAMPLE2_PROPERTIES サイズ: 48 バイト(x86)
dim st, 12 ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; cbData : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwTypeSpecificFlags : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; dwSampleFlags : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; lActual : INT (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; tStart : LONGLONG (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; tStop : LONGLONG (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; dwStreamId : DWORD (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; pMediaType : AM_MEDIA_TYPE* (+36, 4byte) varptr(st)+36 を基点に操作(4byte:入れ子/配列)
; pbBuffer : BYTE* (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; cbBuffer : INT (+44, 4byte) st.11 = 値 / 値 = st.11 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; AM_SAMPLE2_PROPERTIES サイズ: 64 バイト(x64)
dim st, 16 ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; cbData : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwTypeSpecificFlags : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; dwSampleFlags : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; lActual : INT (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; tStart : LONGLONG (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; tStop : LONGLONG (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; dwStreamId : DWORD (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; pMediaType : AM_MEDIA_TYPE* (+40, 8byte) varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; pbBuffer : BYTE* (+48, 8byte) qpoke st,48,値 / qpeek(st,48) ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; cbBuffer : INT (+56, 4byte) st.14 = 値 / 値 = st.14 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global AM_SAMPLE2_PROPERTIES
#field int cbData
#field int dwTypeSpecificFlags
#field int dwSampleFlags
#field int lActual
#field int64 tStart
#field int64 tStop
#field int dwStreamId
#field intptr pMediaType
#field intptr pbBuffer
#field int cbBuffer
#endstruct
stdim st, AM_SAMPLE2_PROPERTIES ; NSTRUCT 変数を確保
st->cbData = 100
mes "cbData=" + st->cbData