Structure SpatialAudioClientActivationParams (spatialaudioclient.h)

Article
03/02/2024

Représente les paramètres d’activation facultatifs pour un flux de rendu audio spatial. Transmettez cette structure à ActivateAudioInterfaceAsync lors de l’activation d’une interface ISpatialAudioClient .

Syntaxe

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

Membres

tracingContextId

Identificateur de contexte défini par l’application, utilisé pour la journalisation des événements.

appId

Identificateur de l’application cliente, utilisé pour la journalisation des événements.

majorVersion

Numéro de version principal de l’application cliente, utilisé pour la journalisation des événements.

minorVersion1

Premier numéro de version secondaire de l’application cliente, utilisé pour la journalisation des événements.

minorVersion2

Numéro de version secondaire de l’application cliente, utilisé pour la journalisation des événements.

####### minorVersion3

Troisième numéro de version secondaire de l’application cliente, utilisé pour la journalisation des événements.

majorVersion

minorVersion1

minorVersion2

minorVersion3

Remarques

L’exemple de code suivant montre comment initialiser cette structure.

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

Pour accéder à ActivateAudioIntefaceAsync, vous devez créer un lien vers mmdevapi.lib.

Configuration requise

Condition requise	Valeur
En-tête	spatialaudioclient.h

Partager via