Compartilhar via

Enumeração EPcMiniportEngineEvent (portcls.h)

  • Artigo

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