SpatialAudioClientActivationParams 構造体 (spatialaudioclient.h)

[アーティクル]
03/02/2024

空間オーディオレンダリングストリームのオプションのアクティブ化パラメーターを表します。 ISpatialAudioClient インターフェイスをアクティブ化するときに、この構造体を ActivateAudioInterfaceAsync に渡します。

構文

typedef struct SpatialAudioClientActivationParams {
  GUID tracingContextId;
  GUID appId;
  int  majorVersion;
  int  minorVersion1;
  int  minorVersion2;
  int  minorVersion3;
} SpatialAudioClientActivationParams;

メンバー

tracingContextId

イベントログに使用されるアプリ定義のコンテキスト識別子。

appId

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

majorVersion

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

minorVersion1

イベントログに使用されるクライアントアプリの最初のマイナーバージョン番号。

minorVersion2

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

####### minorVersion3

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

majorVersion

minorVersion1

minorVersion2

minorVersion3

注釈

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

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 にリンクする必要があります。

要件

要件	値
Header	spatialaudioclient.h