> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # SHAPE_EQCOMP_CONTEXT > SHAPE_EQCOMP_CONTEXT # SHAPE\_EQCOMP\_CONTEXT O contexto do equalizador e do compressor (EQComp). ## Sintaxe ```cpp theme={null} typedef struct SHAPE_EQCOMP_CONTEXT { UINT32 timestamp : 21; UINT32 reserved0 : 2; UINT32 internalSaturate : 1; UINT32 mixBufPeakMag : 4; UINT32 peakMag : 4; UINT32 eqAB0 : 24; UINT32 eqAB1_L : 8; UINT32 eqAB1_H : 16; UINT32 eqAB2_L : 16; UINT32 eqAB2_H : 8; UINT32 eqAA1 : 24; UINT32 eqAA2 : 24; UINT32 eqBB0_L : 8; UINT32 eqBB0_H : 16; UINT32 eqBB1_L : 16; UINT32 eqBB1_H : 8; UINT32 eqBB2 : 24; UINT32 eqBA1 : 24; UINT32 eqBA2_L : 8; UINT32 eqBA2_H : 16; UINT32 eqCB0_L : 16; UINT32 eqCB0_H : 8; UINT32 eqCB1 : 24; UINT32 eqCB2 : 24; UINT32 eqCA1_L : 8; UINT32 eqCA1_H : 16; UINT32 eqCA2_L : 16; UINT32 eqCA2_H : 8; UINT32 reserved1 : 24; UINT32 eqAInputDelay0 : 24; UINT32 reserved2 : 8; UINT32 eqAInputDelay1 : 24; UINT32 reserved3 : 8; UINT32 eqDelayElements2; UINT32 eqDelayElements3; UINT32 eqDelayElements4; UINT32 eqDelayElements5; UINT32 eqDelayElements6; UINT32 eqDelayElements7; UINT32 compInputLevel; UINT32 compGainReduction : 24; UINT32 reserved4 : 8; UINT32 compGain : 16; UINT32 reserved5 : 16; UINT32 eqAB0Target : 24; UINT32 eqAB1Target_L : 8; UINT32 eqAB1Target_H : 16; UINT32 eqAB2Target_L : 16; UINT32 eqAB2Target_H : 8; UINT32 eqAA1Target : 24; UINT32 eqAA2Target : 24; UINT32 eqBB0Target_L : 8; UINT32 eqBB0Target_H : 16; UINT32 eqBB1Target_L : 16; UINT32 eqBB1Target_H : 8; UINT32 eqBB2Target : 24; UINT32 eqBA1Target : 24; UINT32 eqBA2Target_L : 8; UINT32 eqBA2Target_H : 16; UINT32 eqCB0Target_L : 16; UINT32 eqCB0Target_H : 8; UINT32 eqCB1Target : 24; UINT32 eqCB2Target : 24; UINT32 eqCA1Target_L : 8; UINT32 eqCA1Target_H : 16; UINT32 eqCA2Target_L : 16; UINT32 eqCA2Target_H : 8; UINT32 reserved6 : 24; UINT32 compRelease : 24; UINT32 reserved7 : 2; UINT32 compExpand : 1; UINT32 compLogGain : 1; UINT32 compSidechainMode : 2; UINT32 compMode : 1; UINT32 compEnable : 1; UINT32 compThreshold : 24; UINT32 reserved8 : 8; UINT32 compAttack : 24; UINT32 reserved9 : 8; UINT32 compOneOverRatio : 16; UINT32 compGainTarget : 16; } SHAPE_EQCOMP_CONTEXT ``` ### Membros *timestamp*\ Tipo: UINT32 Leitura: carimbo de data/hora da conclusão do processamento do contexto. *Reserved0*\ Tipo: UINT32 Reservado. *internalSaturate*\ Tipo: UINT32 Leitura: 1 se o EQ/Comp estiver saturado; caso contrário, 0. *mixBufPeakMag*\ Tipo: UINT32 Leitura: magnitude de pico do buffer de mixagem de saída. *peakMag*\ Tipo: UINT32 Leitura: magnitude de pico da saída. *eqAB0*\ Tipo: UINT32 Leitura/Gravação: coeficiente b0 do filtro de equalizador A. *eqAB1\_L*\ Tipo: UINT32 Leitura/Gravação: coeficiente b1 do filtro de equalizador A, 8 bits inferiores. *eqAB1\_H*\ Tipo: UINT32 Leitura/Gravação: coeficiente b1 do filtro de equalizador A, 16 bits superiores. *eqAB2\_L*\ Tipo: UINT32 Leitura/Gravação: coeficiente b2 do filtro de equalizador A, 16 bits inferiores. *eqAB2\_H*\ Tipo: UINT32 Leitura/Gravação: coeficiente b2 do filtro de equalizador A, 8 bits superiores. *eqAA1*\ Tipo: UINT32 Leitura/Gravação: coeficiente a1 do filtro de equalizador A. *eqAA2*\ Tipo: UINT32 Leitura/Gravação: coeficiente a2 do filtro de equalizador A. *eqBB0\_L*\ Tipo: UINT32 Leitura/Gravação: coeficiente b0 do filtro de equalizador B, 8 bits inferiores. *eqBB0\_H*\ Tipo: UINT32 Leitura/Gravação: coeficiente b0 do filtro de equalizador B, 16 bits superiores. *eqBB1\_L*\ Tipo: UINT32 Leitura/Gravação: coeficiente b1 do filtro de equalizador B, 16 bits inferiores. *eqBB1\_H*\ Tipo: UINT32 Leitura/Gravação: coeficiente b1 do filtro de equalizador B, 8 bits superiores. *eqBB2*\ Tipo: UINT32 Leitura/Gravação: coeficiente b2 do filtro de equalizador B. *eqBA1*\ Tipo: UINT32 Leitura/Gravação: coeficiente a1 do filtro de equalizador B. *eqBA2\_L*\ Tipo: UINT32 Leitura/Gravação: coeficiente a2 do filtro de equalizador B, 8 bits inferiores. *eqBA2\_H*\ Tipo: UINT32 Leitura/Gravação: coeficiente a2 do filtro de equalizador B, 16 bits superiores. *eqCB0\_L*\ Tipo: UINT32 Leitura/Gravação: coeficiente b0 do filtro de equalizador C, 16 bits inferiores. *eqCB0\_H*\ Tipo: UINT32 Leitura/Gravação: coeficiente b0 do filtro de equalizador C, 8 bits superiores. *eqCB1*\ Tipo: UINT32 Leitura/Gravação: coeficiente b1 do filtro de equalizador C. *eqCB2*\ Tipo: UINT32 Leitura/Gravação: coeficiente b2 do filtro de equalizador C. *eqCA1\_L*\ Tipo: UINT32 Leitura/Gravação: coeficiente a1 do filtro de equalizador C, 8 bits inferiores. *eqCA1\_H*\ Tipo: UINT32 Leitura/Gravação: coeficiente a1 do filtro de equalizador C, 16 bits superiores. *eqCA2\_L*\ Tipo: UINT32 Leitura/Gravação: coeficiente a2 do filtro de equalizador C, 16 bits inferiores. *eqCA2\_H*\ Tipo: UINT32 Leitura/Gravação: coeficiente a2 do filtro de equalizador C, 8 bits superiores. *Reserved1*\ Tipo: UINT32 Reservado. *eqAInputDelay0*\ Tipo: UINT32 Leitura: atraso de entrada do canal esquerdo. *Reserved2*\ Tipo: UINT32 Reservado. *eqAInputDelay1*\ Tipo: UINT32 Leitura: atraso de entrada do canal direito. *Reserved*\ Tipo: UINT32 Reservado. *eqDelayElements2*\ Tipo: UINT32 Leitura: elemento de atraso. *eqDelayElements3*\ Tipo: UINT32 Leitura: elemento de atraso. *eqDelayElements4*\ Tipo: UINT32 Leitura: elemento de atraso. *eqDelayElements5*\ Tipo: UINT32 Leitura: elemento de atraso. *eqDelayElements6*\ Tipo: UINT32 Leitura: elemento de atraso. *eqDelayElements7*\ Tipo: UINT32 Leitura: elemento de atraso. *compInputLevel*\ Tipo: UINT32 Leitura: InputLevel calculado para a entrada do compressor, no formato u8.23 (-0x0000\_0000 a 0x7FFF\_FFFF). Os oito bits inteiros permitem que a seção do equalizador tenha um ganho de até 48 dB antes do compressor, sem clipping. *compGainReduction*\ Tipo: UINT32 Leitura: atenuação calculada para o compressor, no formato u1.23 (-0x00\_0000 a 0x80\_0000). Este é um multiplicador linear; um valor de 0x40\_0000, que corresponde a 0,5, é um ganho de -6 dB ou uma redução de ganho de 6 dB. *Reserved4*\ Tipo: UINT32 Reservado. *compGain*\ Tipo: UINT32 Leitura/Gravação: valor atual do ganho de saída (makeup), no formato u3.13 (-0x0000 a 0xFFFF). *Reserved5*\ Tipo: UINT32 Reservado. *eqAB0Target*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente b0 do filtro de equalizador A. *eqAB1Target\_L*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente b1 do filtro de equalizador A, 8 bits inferiores. *eqAB1Target\_H*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente b1 do filtro de equalizador A, 16 bits superiores. *eqAB2Target\_L*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente b2 do filtro de equalizador A, 16 bits inferiores. *eqAB2Target\_H*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente b2 do filtro de equalizador A, 8 bits superiores. *eqAA1Target*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente a1 do filtro de equalizador A. *eqAA2Target*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente a2 do filtro de equalizador A. *eqBB0Target\_L*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente b0 do filtro de equalizador B, 8 bits inferiores. *eqBB0Target\_H*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente b0 do filtro de equalizador B, 16 bits superiores. *eqBB1Target\_L*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente b1 do filtro de equalizador B, 16 bits inferiores. *eqBB1Target\_H*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente b1 do filtro de equalizador B, 8 bits superiores. *eqBB2Target*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente b2 do filtro de equalizador B. *eqBA1Target*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente a1 do filtro de equalizador B. *eqBA2Target\_L*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente a2 do filtro de equalizador B, 8 bits inferiores. *eqBA2Target\_H*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente a2 do filtro de equalizador B, 16 bits superiores. *eqCB0Target\_L*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente b0 do filtro de equalizador C, 16 bits inferiores. *eqCB0Target\_H*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente b0 do filtro de equalizador C, 8 bits superiores. *eqCB1Target*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente b1 do filtro de equalizador C. *eqCB2Target*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente b2 do filtro de equalizador C. *eqCA1Target\_L*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente a1 do filtro de equalizador C, 8 bits inferiores. *eqCA1Target\_H*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente a1 do filtro de equalizador C, 16 bits superiores. *eqCA2Target\_L*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente a2 do filtro de equalizador C, 16 bits inferiores. *eqCA2Target\_H*\ Tipo: UINT32 Leitura/Gravação: destino do coeficiente a2 do filtro de equalizador C, 8 bits superiores. *Reserved6*\ Tipo: UINT32 Reservado. *compRelease*\ Tipo: UINT32 Gravação: taxa de liberação do compressor, no formato u1.23 (-0x00\_0001 a 0x80\_0000). Essa é a quantidade pela qual *compGainReduction* é incrementado a cada período de amostra quando o compressor/expansor está na fase de liberação. Se *compLogGain* estiver definido, *compRelease* será deslocado para a direita para alinhar o bit 23 com o bit mais significativo do valor atual de *compGainReduction*; isso faz com que o incremento seja exponencial. O valor 0 não é válido para este membro e causará operação incorreta. *Reserved7*\ Tipo: UINT32 Reservado. *compExpand*\ Tipo: UINT32 Gravação: consulte SHAPE\_EQCOMP\_EXPAND\_MODE. *compLogGain*\ Tipo: UINT32 Gravação: consulte SHAPE\_EQCOMP\_LOG\_GAIN. Isso faz com que as fases de ataque e liberação decrementem e incrementem a redução de ganho exponencialmente, para torná-la linear no espaço logarítmico; ou seja, linear em dB. *compSidechainMode*\ Tipo: UINT32 Gravação: consulte SHAPE\_EQCOMP\_SIDECHAIN\_MODE. *compMode*\ Tipo: UINT32 Gravação: consulte SHAPE\_EQCOMP\_COMPRESSOR\_MODE. *compEnable*\ Tipo: UINT32 Gravação: 1 == habilitado, 0 == desabilitado. *compThreshold*\ Tipo: UINT32 Gravação: valor de limite, no formato u1.23 (-0x00\_0000 a 0x80\_0000). *Reserved8*\ Tipo: UINT32 Reservado. *compAttack*\ Tipo: UINT32 Gravação: taxa de ataque do compressor, no formato u1.23 (-0x00\_0001 a 0x80\_0000). Essa é a quantidade pela qual *compGainReduction* é decrementado a cada período de amostra quando o compressor/expansor está na fase de ataque. Se *compLogGain* estiver definido, *compAttack* será deslocado para a direita para alinhar o bit 23 com o bit mais significativo do valor atual de *compGainReduction*; isso faz com que o incremento seja exponencial. O valor 0 não é válido para este membro e causará operação incorreta. *Reserved9*\ Tipo: UINT32 Reservado. *compOneOverRatio*\ Tipo: UINT32 Gravação: inclinação do compressor, no formato u1.15 (-0x0000 a 0x8000). Este é o recíproco do controle de taxa tradicional dos compressores. Para uma taxa de 1:1, defina *compOneOverRatio* como 0x8000. Para uma taxa de 4:1, defina *compOneOverRatio* como 0x2000. O valor 0x0000 é uma taxa de infinito:1. *compGainTarget*\ Tipo: UINT32 Gravação: destino definível pelo usuário para o ganho de saída (makeup). Durante um quadro de áudio, o ganho fará uma rampa do valor atual até *compGainTarget*, no formato u3.13 (-0x0000 a 0xFFFF). ## Comentários Esta estrutura contém o contexto do equalizador (EQ) e do compressor. O Scalable Hardware Audio Processing Engine (SHAPE) pode processar até 512 contextos EQComp por quadro de áudio. Para obter mais informações, consulte [Equalização e compressão](/pt-BR/build/console-features/audio/overviews/shape-overview#ID4ECF) em [Visão geral do SHAPE](/pt-BR/build/console-features/audio/overviews/shape-overview). ## Requisitos **Cabeçalho:** shapeeqcompcontext.h **Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series ## Documentação conceitual * [Visão geral do ACP](/pt-BR/build/console-features/audio/overviews/acp-overview) ## Confira também [ShapeEqCompContext](/pt-BR/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members) ## Related topics - [SHAPE_EQCOMP_CONTEXT](/reference/audio/shapeeqcompcontext/structs/shape_eqcomp_context.md) - [ShapeEqCompContext](/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members.md)