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

用於事件記錄的第二個用戶端應用程式次要版本號碼。

####### minorVersion3

用於事件記錄的第三個用戶端應用程式次要版本號碼。

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。

規格需求

需求	值
標頭	spatialaudioclient.h

Share via