SpatialAudioClientActivationParams-Struktur (spatialaudioclient.h)

Artikel
03/02/2024

Stellt optionale Aktivierungsparameter für einen räumlichen Audiorenderungsstream dar. Übergeben Sie diese Struktur an ActivateAudioInterfaceAsync , wenn Sie eine ISpatialAudioClient-Schnittstelle aktivieren.

Syntax

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

Member

tracingContextId

Ein von der App definierter Kontextbezeichner, der für die Ereignisprotokollierung verwendet wird.

appId

Ein Bezeichner für die Client-App, der für die Ereignisprotokollierung verwendet wird.

majorVersion

Die Hauptversionsnummer der Client-App, die für die Ereignisprotokollierung verwendet wird.

minorVersion1

Die erste Nebenversionsnummer der Client-App, die für die Ereignisprotokollierung verwendet wird.

minorVersion2

Die zweite Nebenversionsnummer der Client-App, die für die Ereignisprotokollierung verwendet wird.

####### minorVersion3

Die dritte Nebenversionsnummer der Client-App, die für die Ereignisprotokollierung verwendet wird.

majorVersion

minorVersion1

minorVersion2

minorVersion3

Hinweise

Der folgende Beispielcode zeigt, wie diese Struktur initialisiert wird.

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);

Um auf ActivateAudioIntefaceAsync zuzugreifen, müssen Sie einen Link zu mmdevapi.lib erstellen.

Anforderungen

Anforderung	Wert
Header	spatialaudioclient.h

Freigeben über