Skip to main content

​
XApuConnect

Estabelece uma conexão e aloca os recursos necessários para uma XAPU (Audio Processing Unit).

​
Sintaxe

​
Parâmetros

params   _In_
Tipo: XApuConnectInputParameters* Parâmetros passados para XApuConnect para alocar recursos. data   _Out_
Tipo: XApuConnectOutputParameters* Parâmetros retornados por XApuConnect. handle   _Outptr_
Tipo: XApuHandle* Ponteiro para um identificador XAPU retornado. Esse identificador é usado para indicar qual instância XAPU manipular ao chamar outras APIs do XAPU.

​
Valor retornado

Tipo: HRESULT Retornará S_OK se tiver êxito; caso contrário, retornará um código de erro.

​
Comentários

O chamador deve especificar um XApuProcessType para o cliente XAPU executar. Uma instância de XAPU pode trabalhar com um tipo de processo durante seu tempo de vida. Para executar dois ou mais processos diferentes, duas ou mais instâncias de XAPU devem ser instanciadas. Dentro de XApuConnectInputParameters, o chamador deve especificar o seguinte:
  • Número máximo de fluxos que o XAPU deve processar simultaneamente.
  • Número máximo de comandos enfileirados para cada fluxo.
  • Alocação total de memória necessária para todos os comandos e fluxos. Isso inclui as alocações totais para dados de entrada, saída e processamento no número máximo de fluxos multiplicado pelos comandos enfileirados por fluxo.
Se a chamada tiver êxito, o parâmetro XApuConnectOutputParameters::baseData apontará para um bloco de memória que o chamador deve usar para passar dados de entrada e recuperar os dados de saída dos fluxos. Cabe ao chamador particionar e reciclar esse bloco de memória. A alocação será liberada na chamada de XApuDisconnect. XApuConnectOutputParameters::resultReadyEvent conterá um identificador de evento Win32 quando XApuConnectOptions::EnableResultReadyEvent estiver definido. Esse identificador será fechado em uma chamada de XApuDisconnect. Esse identificador será fechado em uma chamada de XApuDisconnect. Não é recomendável chamar XapuConnect e XApuDisconnect com frequência para iniciar e parar fluxos, pois essas chamadas são demoradas e também podem levar a perdas de recursos devido à fragmentação da memória. Em vez disso, XapuConnect deve ser chamado uma vez na inicialização da sessão de streaming e, em seguida, XApuCommandType::Activate e XApuCommandType::Deactivate devem ser usados para iniciar e parar fluxos durante o streaming. No final da sessão de streaming, XApuDisconnect deve ser chamado. Isso vale para todos os clientes XAPU.

​
Requisitos

Cabeçalho: xapu.h Biblioteca: xapu.lib Plataformas compatíveis: XBOX Series X|S

​
Documentação conceitual

​
Confira também

XAPU
XApuDecodeConvertCommand
XApuDequeueResult
XApuEnqueueCommand
XApuGetResultCount
Last modified on October 6, 2026