Estrutura SpatialAudioClientActivationParams (spatialaudioclient.h)

Representa parâmetros de ativação opcionais para um fluxo de renderização de áudio espacial. Passe essa estrutura para ActivateAudioInterfaceAsync ao ativar uma interface ISpatialAudioClient .

Sintaxe

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

Membros

tracingContextId

Um identificador de contexto definido pelo aplicativo, usado para registro em log de eventos.

appId

Um identificador para o aplicativo cliente, usado para registro em log de eventos.

Majorversion

O número de versão principal do aplicativo cliente, usado para registro em log de eventos.

minorVersion1

O primeiro número de versão secundária do aplicativo cliente, usado para registro em log de eventos.

minorVersion2

O segundo número de versão secundária do aplicativo cliente, usado para registro em log de eventos.

####### minorVersion3

O terceiro número de versão secundária do aplicativo cliente, usado para registro em log de eventos.

majorVersion

minorVersion1

minorVersion2

minorVersion3

Comentários

O código de exemplo a seguir mostra como inicializar essa estrutura.

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

Para acessar ActivateAudioIntefaceAsync, você precisará vincular a mmdevapi.lib.

Requisitos

Requisito	Valor
Cabeçalho	spatialaudioclient.h