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

KSPROPERTY_TUNER_FREQUENCY_S

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

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

フィールド

フィールドサイズx64x86説明
PropertyKSIDENTIFIER8+0+0対象プロパティを識別するKSIDENTIFIER。プロパティセットGUID・ID・フラグを保持する。
FrequencyDWORD4+8+8設定または取得する同調周波数をHz単位で示す。
LastFrequencyDWORD4+12+12直前に設定されていた周波数をHz単位で示す。
TuningFlagsDWORD4+16+16同調動作を制御するフラグ(KS_TUNER_TUNING_*)。
VideoSubChannelDWORD4+20+20デジタル放送の映像サブチャンネル番号を示す。
AudioSubChannelDWORD4+24+24デジタル放送の音声サブチャンネル番号を示す。
ChannelDWORD4+28+28選局するチャンネル番号を示す。
CountryDWORD4+32+32国コードを示す。地域別の周波数割当に用いる。

各言語での定義

#include <windows.h>

// KSIDENTIFIER  (x64 8 / x86 8 バイト)
typedef struct KSIDENTIFIER {
    _Anonymous_e__Union Anonymous;
} KSIDENTIFIER;

// KSPROPERTY_TUNER_FREQUENCY_S  (x64 40 / x86 40 バイト)
typedef struct KSPROPERTY_TUNER_FREQUENCY_S {
    KSIDENTIFIER Property;
    DWORD Frequency;
    DWORD LastFrequency;
    DWORD TuningFlags;
    DWORD VideoSubChannel;
    DWORD AudioSubChannel;
    DWORD Channel;
    DWORD Country;
} KSPROPERTY_TUNER_FREQUENCY_S;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct KSIDENTIFIER
{
    public _Anonymous_e__Union Anonymous;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct KSPROPERTY_TUNER_FREQUENCY_S
{
    public KSIDENTIFIER Property;
    public uint Frequency;
    public uint LastFrequency;
    public uint TuningFlags;
    public uint VideoSubChannel;
    public uint AudioSubChannel;
    public uint Channel;
    public uint Country;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure KSIDENTIFIER
    Public Anonymous As _Anonymous_e__Union
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure KSPROPERTY_TUNER_FREQUENCY_S
    Public Property As KSIDENTIFIER
    Public Frequency As UInteger
    Public LastFrequency As UInteger
    Public TuningFlags As UInteger
    Public VideoSubChannel As UInteger
    Public AudioSubChannel As UInteger
    Public Channel As UInteger
    Public Country As UInteger
End Structure
import ctypes
from ctypes import wintypes

class KSIDENTIFIER(ctypes.Structure):
    _fields_ = [
        ("Anonymous", _Anonymous_e__Union),
    ]

class KSPROPERTY_TUNER_FREQUENCY_S(ctypes.Structure):
    _fields_ = [
        ("Property", KSIDENTIFIER),
        ("Frequency", wintypes.DWORD),
        ("LastFrequency", wintypes.DWORD),
        ("TuningFlags", wintypes.DWORD),
        ("VideoSubChannel", wintypes.DWORD),
        ("AudioSubChannel", wintypes.DWORD),
        ("Channel", wintypes.DWORD),
        ("Country", wintypes.DWORD),
    ]
#[repr(C)]
pub struct KSIDENTIFIER {
    pub Anonymous: _Anonymous_e__Union,
}

#[repr(C)]
pub struct KSPROPERTY_TUNER_FREQUENCY_S {
    pub Property: KSIDENTIFIER,
    pub Frequency: u32,
    pub LastFrequency: u32,
    pub TuningFlags: u32,
    pub VideoSubChannel: u32,
    pub AudioSubChannel: u32,
    pub Channel: u32,
    pub Country: u32,
}
import "golang.org/x/sys/windows"

type KSIDENTIFIER struct {
	Anonymous _Anonymous_e__Union
}

type KSPROPERTY_TUNER_FREQUENCY_S struct {
	Property KSIDENTIFIER
	Frequency uint32
	LastFrequency uint32
	TuningFlags uint32
	VideoSubChannel uint32
	AudioSubChannel uint32
	Channel uint32
	Country uint32
}
type
  KSIDENTIFIER = record
    Anonymous: _Anonymous_e__Union;
  end;

  KSPROPERTY_TUNER_FREQUENCY_S = record
    Property: KSIDENTIFIER;
    Frequency: DWORD;
    LastFrequency: DWORD;
    TuningFlags: DWORD;
    VideoSubChannel: DWORD;
    AudioSubChannel: DWORD;
    Channel: DWORD;
    Country: DWORD;
  end;
const KSIDENTIFIER = extern struct {
    Anonymous: _Anonymous_e__Union,
};

const KSPROPERTY_TUNER_FREQUENCY_S = extern struct {
    Property: KSIDENTIFIER,
    Frequency: u32,
    LastFrequency: u32,
    TuningFlags: u32,
    VideoSubChannel: u32,
    AudioSubChannel: u32,
    Channel: u32,
    Country: u32,
};
type
  KSIDENTIFIER {.bycopy.} = object
    Anonymous: _Anonymous_e__Union

  KSPROPERTY_TUNER_FREQUENCY_S {.bycopy.} = object
    Property: KSIDENTIFIER
    Frequency: uint32
    LastFrequency: uint32
    TuningFlags: uint32
    VideoSubChannel: uint32
    AudioSubChannel: uint32
    Channel: uint32
    Country: uint32
struct KSIDENTIFIER
{
    _Anonymous_e__Union Anonymous;
}

struct KSPROPERTY_TUNER_FREQUENCY_S
{
    KSIDENTIFIER Property;
    uint Frequency;
    uint LastFrequency;
    uint TuningFlags;
    uint VideoSubChannel;
    uint AudioSubChannel;
    uint Channel;
    uint Country;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; KSPROPERTY_TUNER_FREQUENCY_S サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; Property : KSIDENTIFIER (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; Frequency : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; LastFrequency : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; TuningFlags : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; VideoSubChannel : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; AudioSubChannel : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; Channel : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; Country : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global KSIDENTIFIER
    #field byte Anonymous 8
#endstruct

#defstruct global KSPROPERTY_TUNER_FREQUENCY_S
    #field KSIDENTIFIER Property
    #field int Frequency
    #field int LastFrequency
    #field int TuningFlags
    #field int VideoSubChannel
    #field int AudioSubChannel
    #field int Channel
    #field int Country
#endstruct

stdim st, KSPROPERTY_TUNER_FREQUENCY_S        ; NSTRUCT 変数を確保
st->Frequency = 100
mes "Frequency=" + st->Frequency