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

AM_SAMPLE2_PROPERTIES

構造体
サイズx64: 64 バイト / x86: 48 バイト

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

フィールド

フィールドサイズx64x86説明
cbDataDWORD4+0+0プロパティデータの長さ (バイト単位)。この構造体メンバーは拡張性のために用意されています。
dwTypeSpecificFlagsDWORD4+4+4

型固有のフラグです。フラグはメディアタイプごとに個別に定義されます。既定値は AM_VIDEO_FLAG_INTERLEAVED_FRAME (0) です。次のフラグはビデオストリームに使用されます。これらはヘッダーファイル dvdmedia.h で定義されています。

フラグ 意味
AM_VIDEO_FLAG_FIELD_MASK
0x0003
サンプルがフィールドとフレームのどちらであるかを調べるには、このマスクを使用します。
AM_VIDEO_FLAG_INTERLEAVED_FRAME
0x0000
サンプルはフレームです。(この値を判定するには AM_VIDEO_FLAG_FIELD_MASK ビットマスクを使用します。)
AM_VIDEO_FLAG_FIELD1
0x0001
サンプルはフィールド 1 です。(この値を判定するには AM_VIDEO_FLAG_FIELD_MASK ビットマスクを使用します。)
AM_VIDEO_FLAG_FIELD2
0x0002
サンプルはフィールド 2 です。(この値を判定するには AM_VIDEO_FLAG_FIELD_MASK ビットマスクを使用します。)
AM_VIDEO_FLAG_FIELD1FIRST
0x0004
このフラグが設定されている場合は、フィールド 1 を先に表示します。設定されていない場合は、フィールド 2 を先に表示します。(サンプルごとに 2 つのフィールドがある場合にのみ適用されます。)
AM_VIDEO_FLAG_WEAVE
0x0008
このフラグが設定されている場合は weave モードを使用します (つまり、サンプルをデインターレースしません)。設定されていない場合は bob モードを使用します。このフラグは、サンプルごとに 2 つのフィールドがある場合にのみ適用されます。
AM_VIDEO_FLAG_REPEAT_FIELD
0x0040
このフラグが設定されている場合は、2 番目のフィールドを表示した後に最初のフィールドをもう一度表示します。(サンプルごとに 2 つのフィールドがある場合にのみ適用されます。)
AM_ReverseBlockStart
0x2
DVD ビデオの逆方向再生中に、VOBU の開始を通知します。詳細については、DVD Playback Enhancements in Windows Vista を参照してください。
AM_ReverseBlockEnd
0x4
DVD ビデオの逆方向再生中に、VOBU の終了を通知します。DVD Navigator は、VOBU の終了を通知するために空のサンプルにこのフラグを設定します。詳細については、DVD Playback Enhancements in Windows Vista を参照してください。
AM_UseNewCSSKey
0x1
DVD 再生において、デコーダーが新しい Content Scramble System (CSS) キーを適用すべきストリーム内の位置を示します。

DVD Navigator は、CSS タイトルキーを再ネゴシエートする直前に、空のメディアサンプルにこのフラグを設定します。

以前は、DVD Navigator はディスクキーをネゴシエートする前に誤ってこのキーを送信していました。Windows 7 以降では、デコーダーの AM_PROPERTY_DVDCOPY_SUPPORTS_NEW_KEYCOUNT プロパティが TRUE を返す場合、DVD Navigator はディスクキーをネゴシエートする前にこのフラグを送信しません。DVD Copy Protection Property Set を参照してください。

その他のフラグも定義されていますが、現在は使用されていません。dvdmedia.h を参照してください。

dwSampleFlagsDWORD4+8+8AM_SAMPLE_PROPERTY_FLAGS 列挙データ型のフラグのビット単位の組み合わせです。未定義のビットは予約済みであり、0 でなければなりません。
lActualINT4+12+12バッファー内の有効なデータの長さです。
tStartLONGLONG8+16+16開始時刻です (有効な場合)。このメンバーが有効かどうかは dwSampleFlags メンバーで指定されます。
tStopLONGLONG8+24+24停止時刻です (有効な場合)。このメンバーが有効かどうかは dwSampleFlags メンバーで指定されます。
dwStreamIdDWORD4+32+32ストリーム識別子です。値が AM_STREAM_MEDIA の場合、ストリームにはメディアデータが含まれます。値が AM_STREAM_CONTROL の場合、ストリームには制御情報が含まれます。アプリケーションは、独自の用途のために 0x80000000 以上の値を定義できます。(AM_SAMPLE_PROPERTY_FLAGS を参照してください。)
pMediaTypeAM_MEDIA_TYPE*8/4+40+36フォーマットが変更された場合に、メディアタイプを指定する AM_MEDIA_TYPE 構造体へのポインターです。フォーマットが変更されていない場合、このメンバーは NULL です。
pbBufferBYTE*8/4+48+40サンプルバッファーへのポインターです。
cbBufferINT4+56+44サンプルバッファーのサイズ (バイト単位)。

公式ドキュメント

[このページに関連する機能である DirectShow はレガシー機能です。この機能は MediaPlayerIMFMediaEngine、および Audio/Video Capture in Media Foundation に置き換えられました。これらの機能は Windows 10 および Windows 11 向けに最適化されています。Microsoft は、可能な場合は新しいコードで DirectShow ではなく MediaPlayerIMFMediaEngineAudio/Video Capture in Media Foundation を使用することを強く推奨します。レガシー API を使用している既存のコードについても、可能であれば新しい API を使用するように書き直すことを推奨します。]

AM_SAMPLE2_PROPERTIES 構造体は、メディアサンプルのプロパティを記述します。IMediaSample2 インターフェイスはこの構造体を使用します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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 Structure
import 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: int32
struct 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