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

KSDATARANGE_AUDIO

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

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

フィールド

フィールド型サイズx64x86説明
DataRangeKSDATAFORMAT64+0+0基底となるKSDATAFORMATデータ範囲記述子である。
MaximumChannelsDWORD4+64+64サポートする最大チャンネル数を示す。
MinimumBitsPerSampleDWORD4+68+681サンプルあたりの最小ビット数を示す。
MaximumBitsPerSampleDWORD4+72+721サンプルあたりの最大ビット数を示す。
MinimumSampleFrequencyDWORD4+76+76サポートする最小サンプリング周波数をHzで示す。
MaximumSampleFrequencyDWORD4+80+80サポートする最大サンプリング周波数をHzで示す。

各言語での定義

#include <windows.h>

// KSDATAFORMAT  (x64 64 / x86 64 バイト)
typedef struct KSDATAFORMAT {
    _Anonymous_e__Struct Anonymous;
    LONGLONG Alignment;
} KSDATAFORMAT;

// KSDATARANGE_AUDIO  (x64 88 / x86 88 バイト)
typedef struct KSDATARANGE_AUDIO {
    KSDATAFORMAT DataRange;
    DWORD MaximumChannels;
    DWORD MinimumBitsPerSample;
    DWORD MaximumBitsPerSample;
    DWORD MinimumSampleFrequency;
    DWORD MaximumSampleFrequency;
} KSDATARANGE_AUDIO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct KSDATAFORMAT
{
    public _Anonymous_e__Struct Anonymous;
    public long Alignment;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct KSDATARANGE_AUDIO
{
    public KSDATAFORMAT DataRange;
    public uint MaximumChannels;
    public uint MinimumBitsPerSample;
    public uint MaximumBitsPerSample;
    public uint MinimumSampleFrequency;
    public uint MaximumSampleFrequency;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure KSDATAFORMAT
    Public Anonymous As _Anonymous_e__Struct
    Public Alignment As Long
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure KSDATARANGE_AUDIO
    Public DataRange As KSDATAFORMAT
    Public MaximumChannels As UInteger
    Public MinimumBitsPerSample As UInteger
    Public MaximumBitsPerSample As UInteger
    Public MinimumSampleFrequency As UInteger
    Public MaximumSampleFrequency As UInteger
End Structure
import ctypes
from ctypes import wintypes

class KSDATAFORMAT(ctypes.Structure):
    _fields_ = [
        ("Anonymous", _Anonymous_e__Struct),
        ("Alignment", ctypes.c_longlong),
    ]

class KSDATARANGE_AUDIO(ctypes.Structure):
    _fields_ = [
        ("DataRange", KSDATAFORMAT),
        ("MaximumChannels", wintypes.DWORD),
        ("MinimumBitsPerSample", wintypes.DWORD),
        ("MaximumBitsPerSample", wintypes.DWORD),
        ("MinimumSampleFrequency", wintypes.DWORD),
        ("MaximumSampleFrequency", wintypes.DWORD),
    ]
#[repr(C)]
pub struct KSDATAFORMAT {
    pub Anonymous: _Anonymous_e__Struct,
    pub Alignment: i64,
}

#[repr(C)]
pub struct KSDATARANGE_AUDIO {
    pub DataRange: KSDATAFORMAT,
    pub MaximumChannels: u32,
    pub MinimumBitsPerSample: u32,
    pub MaximumBitsPerSample: u32,
    pub MinimumSampleFrequency: u32,
    pub MaximumSampleFrequency: u32,
}
import "golang.org/x/sys/windows"

type KSDATAFORMAT struct {
	Anonymous _Anonymous_e__Struct
	Alignment int64
}

type KSDATARANGE_AUDIO struct {
	DataRange KSDATAFORMAT
	MaximumChannels uint32
	MinimumBitsPerSample uint32
	MaximumBitsPerSample uint32
	MinimumSampleFrequency uint32
	MaximumSampleFrequency uint32
}
type
  KSDATAFORMAT = record
    Anonymous: _Anonymous_e__Struct;
    Alignment: Int64;
  end;

  KSDATARANGE_AUDIO = record
    DataRange: KSDATAFORMAT;
    MaximumChannels: DWORD;
    MinimumBitsPerSample: DWORD;
    MaximumBitsPerSample: DWORD;
    MinimumSampleFrequency: DWORD;
    MaximumSampleFrequency: DWORD;
  end;
const KSDATAFORMAT = extern struct {
    Anonymous: _Anonymous_e__Struct,
    Alignment: i64,
};

const KSDATARANGE_AUDIO = extern struct {
    DataRange: KSDATAFORMAT,
    MaximumChannels: u32,
    MinimumBitsPerSample: u32,
    MaximumBitsPerSample: u32,
    MinimumSampleFrequency: u32,
    MaximumSampleFrequency: u32,
};
type
  KSDATAFORMAT {.bycopy.} = object
    Anonymous: _Anonymous_e__Struct
    Alignment: int64

  KSDATARANGE_AUDIO {.bycopy.} = object
    DataRange: KSDATAFORMAT
    MaximumChannels: uint32
    MinimumBitsPerSample: uint32
    MaximumBitsPerSample: uint32
    MinimumSampleFrequency: uint32
    MaximumSampleFrequency: uint32
struct KSDATAFORMAT
{
    _Anonymous_e__Struct Anonymous;
    long Alignment;
}

struct KSDATARANGE_AUDIO
{
    KSDATAFORMAT DataRange;
    uint MaximumChannels;
    uint MinimumBitsPerSample;
    uint MaximumBitsPerSample;
    uint MinimumSampleFrequency;
    uint MaximumSampleFrequency;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; KSDATARANGE_AUDIO サイズ: 88 バイト(x64)
dim st, 22    ; 4byte整数×22(構造体サイズ 88 / 4 切り上げ)
; DataRange : KSDATAFORMAT (+0, 64byte)  varptr(st)+0 を基点に操作(64byte:入れ子/配列)
; MaximumChannels : DWORD (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; MinimumBitsPerSample : DWORD (+68, 4byte)  st.17 = 値  /  値 = st.17   (lpoke/lpeek も可)
; MaximumBitsPerSample : DWORD (+72, 4byte)  st.18 = 値  /  値 = st.18   (lpoke/lpeek も可)
; MinimumSampleFrequency : DWORD (+76, 4byte)  st.19 = 値  /  値 = st.19   (lpoke/lpeek も可)
; MaximumSampleFrequency : DWORD (+80, 4byte)  st.20 = 値  /  値 = st.20   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global KSDATARANGE_AUDIO
    #field byte DataRange 64
    #field int MaximumChannels
    #field int MinimumBitsPerSample
    #field int MaximumBitsPerSample
    #field int MinimumSampleFrequency
    #field int MaximumSampleFrequency
#endstruct

stdim st, KSDATARANGE_AUDIO        ; NSTRUCT 変数を確保
st->MaximumChannels = 100
mes "MaximumChannels=" + st->MaximumChannels
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。