Enumeração EPcMiniportEngineEvent (portcls.h)

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 miniporte pode relatar usando retornos de chamada por meio do driver de classe de porta (PortCls).

Syntax

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 falha".
eMINIPORT_LAST_BUFFER_RENDERED Especifica a ID do último buffer que foi renderizado.
eMINIPORT_PROCESSING_MODE Especifica a ID para o 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 para o valor enumerado mais alto que foi usado para relatar a falha.

Comentários

A tabela a seguir mostra os membros da enumeração EPcMiniportEngineEvent que foram introduzidos com 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 do buffer linear atual.	Posição de gravação do WaveRTBuffer atual.	Comprimento dos dados concluído.	0
Estado do pino.	Posição do buffer linear atual.	Posição de gravação do WaveRTBuffer atual.	0 – KS_STOP 1 – KS_ACQUIRE 2 – KS_PAUSE 3 – KS_RUN	0
Obter a posição do fluxo.	Posição do buffer linear atual.	Posição de gravação do WaveRTBuffer atual.	0	0
Defina a posição de gravação do buffer WaveRT.	Posição do buffer linear atual.	Posição de gravação do WaveRTBuffer atual que foi recebida de PortCls.	Posição de gravação WaveRTBuffer de destino recebida de PortCls.	0
Obter a posição da apresentação.	Posição do buffer linear atual.	Posição de gravação do WaveRTBuffer atual.	Posição da apresentação.	0
DMA do programa.	Posição do buffer linear atual.	Posição de gravação do WaveRTBuffer atual.	Iniciando o deslocamento de WaveRtBuffer	Comprimento dos dados.
Detecção de falhas.	Posição do buffer linear atual.	Posição de gravação do WaveRTBuffer atual.	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 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 do buffer linear atual.	A última posição de gravação wavertbuffer que o driver recebeu.	0	0
Modo de processamento.	Posição do buffer linear atual.	Posição de gravação do WaveRTBuffer atual.	Primeiros 8 bytes de GUID.	Segundo 8 bytes de GUID.
ID da classe FX.	Posição do buffer linear atual.	Posição de gravação do WaveRTBuffer atual.	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
Cliente mínimo com suporte	Windows 8
Servidor mínimo com suporte	Windows Server 2012
Cabeçalho	portcls.h

Confira também

Relatório de falhas para áudio descarregado

MiniportWriteEtwEvent