Enumeração EPcMiniportEngineEvent (portcls.h)

Artigo
02/07/2025

Este tópico apresenta a enumeração EPcMiniportEngineEvent e descreve os parâmetros que fornecem informações adicionais quando o driver de miniporto relata um erro de falha.

As IDs de evento na enumeração a seguir representam eventos que o driver de miniporto pode relatar usando retornos de chamada por meio do driver de classe de porta (PortCls).

Sintaxe

typedef enum {
  eMINIPORT_IHV_DEFINED,
  eMINIPORT_BUFFER_COMPLETE,
  eMINIPORT_PIN_STATE,
  eMINIPORT_GET_STREAM_POSITION,
  eMINIPORT_SET_WAVERT_BUFFER_WRITE_POSITION,
  eMINIPORT_GET_PRESENTATION_POSITION,
  eMINIPORT_PROGRAM_DMA,
  eMINIPORT_GLITCH_REPORT,
  eMINIPORT_LAST_BUFFER_RENDERED,
  eMINIPORT_PROCESSING_MODE,
  eMINIPORT_FX_CLSID,
  eMINIPORT_MaxValue
} EPcMiniportEngineEvent;

Constantes


`eMINIPORT_IHV_DEFINED` Especifica a ID de um evento definido por IHV.
`eMINIPORT_BUFFER_COMPLETE` Especifica a ID do evento de conclusão do buffer.
`eMINIPORT_PIN_STATE` Especifica a ID do evento relacionado a uma alteração no estado do pin.
`eMINIPORT_GET_STREAM_POSITION` Especifica a ID de um evento "obter posição de fluxo".
`eMINIPORT_SET_WAVERT_BUFFER_WRITE_POSITION` Especifica a ID de um evento de "posição de gravação do buffer de onda".
`eMINIPORT_GET_PRESENTATION_POSITION` Especifica a ID de um evento "obter posição de apresentação".
`eMINIPORT_PROGRAM_DMA` Especifica a ID de um evento "DMA do programa".
`eMINIPORT_GLITCH_REPORT` Especifica a ID de um evento de "relatório de falhas".
`eMINIPORT_LAST_BUFFER_RENDERED` Especifica a ID do último buffer que foi renderizado.
`eMINIPORT_PROCESSING_MODE` Especifica a ID do modo de processamento que estava em vigor quando a falha aconteceu.
`eMINIPORT_FX_CLSID` Especifica a ID da classe para o efeito de processamento de áudio (FX) que estava em vigor quando a falha aconteceu.
`eMINIPORT_MaxValue` Especifica a ID do valor enumerado mais alto usado para relatar a falha.

Observações

A tabela a seguir mostra os membros da enumeração EPcMiniportEngineEvent que foram introduzidas com o Windows 8. A tabela mostra os eventos associados aos membros da enumeração e os significados de seus parâmetros.

Tipo de evento	Parâmetro 1	Parâmetro 2	Parâmetro 3	Parâmetro 4
Tipo de evento específico de IHV.	Definido e usado por IHVs.	Definido e usado por IHVs.	Definido e usado por IHVs.	Definido e usado por IHVs.
Buffer concluído.	Posição de buffer linear atual.	Posição de gravação atual do WaveRTBuffer.	Comprimento dos dados concluído.	0
Estado do pin.	Posição de buffer linear atual.	Posição de gravação atual do WaveRTBuffer.	0 - KS_STOP 1 - KS_ACQUIRE 2 – KS_PAUSE 3 – KS_RUN	0
Obter a posição do fluxo.	Posição de buffer linear atual.	Posição de gravação atual do WaveRTBuffer.	0	0
Defina a posição de gravação do buffer WaveRT.	Posição de buffer linear atual.	Posição de gravação atual do WaveRTBuffer que foi recebida de PortCls.	Posição de gravação waveRTBuffer de destino que foi recebida de PortCls.	0
Obtenha a posição da apresentação.	Posição de buffer linear atual.	Posição de gravação atual do WaveRTBuffer.	Posição da apresentação.	0
DMA do programa.	Posição de buffer linear atual.	Posição de gravação atual do WaveRTBuffer.	Iniciando deslocamento do WaveRtBuffer	Comprimento dos dados.
Detecção de falhas.	Posição de buffer linear atual.	Posição de gravação atual do WaveRTBuffer.	1 – Buffer WaveRT em execução 2 – Erros do decodificador 3 – Receba a mesma posição de gravação do buffer WaveRT duas vezes em uma linha.	Quando o Parâmetro 3 = '3' então o Parâmetro 4 é a posição de gravação ofensiva.

A tabela a seguir mostra os membros da enumeração EPcMiniportEngineEvent que foram introduzidos com o Windows 8.1. A tabela mostra os eventos associados aos membros da enumeração e os significados de seus parâmetros.

Tipo de evento	Parâmetro 1	Parâmetro 2	Parâmetro 3	Parâmetro 4
Último buffer renderizado.	Posição de buffer linear atual.	A última posição de gravação do WaveRtBuffer que o driver recebeu.	0	0
Modo de processamento.	Posição de buffer linear atual.	Posição de gravação atual do WaveRTBuffer.	Primeiros 8 bytes de GUID.	Segundo 8 bytes de GUID.
ID da classe FX.	Posição de buffer linear atual.	Posição de gravação atual do WaveRTBuffer.	Primeiros 8 bytes de FX CLSID.	Segundo 8 bytes de FX CLSID.
Valor máximo.	ID do valor enumerado.	0	0	0

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8
servidor com suporte mínimo	Windows Server 2012
cabeçalho	portcls.h

Consulte também

relatório de falhas para de áudio descarregado

MiniportWriteEtwEvent

Partilhar via