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

SpatialAudioClientActivationParams

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 48 バイト / x86: 48 バイト

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

フィールド

フィールド型サイズx64x86説明
tracingContextIdGUID16+0+0アプリケーションが定義するコンテキスト識別子です。イベント ログに使用されます。
appIdGUID16+16+16

クライアント アプリの識別子です。イベント ログに使用されます。

majorVersion

クライアント アプリのメジャー バージョン番号です。イベント ログに使用されます。

minorVersion1

クライアント アプリの 1 番目のマイナー バージョン番号です。イベント ログに使用されます。

minorVersion2

クライアント アプリの 2 番目のマイナー バージョン番号です。イベント ログに使用されます。

####### minorVersion3

クライアント アプリの 3 番目のマイナー バージョン番号です。イベント ログに使用されます。

majorVersionINT4+32+32アプリのメジャーバージョン番号。
minorVersion1INT4+36+36アプリのマイナーバージョン番号(第1区分)。
minorVersion2INT4+40+40アプリのマイナーバージョン番号(第2区分)。
minorVersion3INT4+44+44アプリのマイナーバージョン番号(第3区分)。

公式ドキュメント

空間オーディオ レンダー ストリームの省略可能なアクティブ化パラメーターを表します。ActivateAudioInterfaceAsync で ISpatialAudioClient インターフェイスをアクティブ化する際に、この構造体を渡します。

解説(Remarks)

次のコード例は、この構造体を初期化する方法を示しています。

PROPVARIANT var; 
PropVariantInit(&var);  
auto p = reinterpret_cast<SpatialAudioClientActivationParams *>(CoTaskMemAlloc(sizeof(SpatialAudioClientActivationParams)));  
if (nullptr == p) { ... } 
p->tracingContextId = /* context identifier */;  
p->appId = /* app identifier */;  
p->majorVersion = /* app version info */;  
p->majorVersionN = /* app version info */;
var.vt = VT_BLOB;
var.blob.cbSize = sizeof(*p);
var.blob.pBlobData = reinterpret_cast<BYTE *>(p); 
hr = ActivateAudioInterfaceAsync(device, __uuidof(ISpatialAudioClient), &var, ...);
// ...
ropVariantClear(&var);

ActivateAudioIntefaceAsync にアクセスするには、mmdevapi.lib にリンクする必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// SpatialAudioClientActivationParams  (x64 48 / x86 48 バイト)
typedef struct SpatialAudioClientActivationParams {
    GUID tracingContextId;
    GUID appId;
    INT majorVersion;
    INT minorVersion1;
    INT minorVersion2;
    INT minorVersion3;
} SpatialAudioClientActivationParams;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SpatialAudioClientActivationParams
{
    public Guid tracingContextId;
    public Guid appId;
    public int majorVersion;
    public int minorVersion1;
    public int minorVersion2;
    public int minorVersion3;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SpatialAudioClientActivationParams
    Public tracingContextId As Guid
    Public appId As Guid
    Public majorVersion As Integer
    Public minorVersion1 As Integer
    Public minorVersion2 As Integer
    Public minorVersion3 As Integer
End Structure
import ctypes
from ctypes import wintypes

class SpatialAudioClientActivationParams(ctypes.Structure):
    _fields_ = [
        ("tracingContextId", GUID),
        ("appId", GUID),
        ("majorVersion", ctypes.c_int),
        ("minorVersion1", ctypes.c_int),
        ("minorVersion2", ctypes.c_int),
        ("minorVersion3", ctypes.c_int),
    ]
#[repr(C)]
pub struct SpatialAudioClientActivationParams {
    pub tracingContextId: GUID,
    pub appId: GUID,
    pub majorVersion: i32,
    pub minorVersion1: i32,
    pub minorVersion2: i32,
    pub minorVersion3: i32,
}
import "golang.org/x/sys/windows"

type SpatialAudioClientActivationParams struct {
	tracingContextId windows.GUID
	appId windows.GUID
	majorVersion int32
	minorVersion1 int32
	minorVersion2 int32
	minorVersion3 int32
}
type
  SpatialAudioClientActivationParams = record
    tracingContextId: TGUID;
    appId: TGUID;
    majorVersion: Integer;
    minorVersion1: Integer;
    minorVersion2: Integer;
    minorVersion3: Integer;
  end;
const SpatialAudioClientActivationParams = extern struct {
    tracingContextId: GUID,
    appId: GUID,
    majorVersion: i32,
    minorVersion1: i32,
    minorVersion2: i32,
    minorVersion3: i32,
};
type
  SpatialAudioClientActivationParams {.bycopy.} = object
    tracingContextId: GUID
    appId: GUID
    majorVersion: int32
    minorVersion1: int32
    minorVersion2: int32
    minorVersion3: int32
struct SpatialAudioClientActivationParams
{
    GUID tracingContextId;
    GUID appId;
    int majorVersion;
    int minorVersion1;
    int minorVersion2;
    int minorVersion3;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SpatialAudioClientActivationParams サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; tracingContextId : GUID (+0, 16byte)  varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; appId : GUID (+16, 16byte)  varptr(st)+16 を基点に操作(16byte:入れ子/配列)
; majorVersion : INT (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; minorVersion1 : INT (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; minorVersion2 : INT (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; minorVersion3 : INT (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global SpatialAudioClientActivationParams
    #field GUID tracingContextId
    #field GUID appId
    #field int majorVersion
    #field int minorVersion1
    #field int minorVersion2
    #field int minorVersion3
#endstruct

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