Enumerazione EPcMiniportEngineEvent (portcls.h)

Articolo
02/07/2025

In questo argomento viene presentata l'enumerazione EPcMiniportEngineEvent e vengono descritti i parametri che forniscono informazioni aggiuntive quando il driver miniport segnala un errore di recupero.

Gli ID evento nell'enumerazione seguente rappresentano gli eventi che il driver miniport può segnalare, usando i callback tramite il driver della classe di porta (PortCls).

Sintassi

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;

Costanti


`eMINIPORT_IHV_DEFINED` Specifica l'ID per un evento definito da IHV.
`eMINIPORT_BUFFER_COMPLETE` Specifica l'ID per l'evento di completamento del buffer.
`eMINIPORT_PIN_STATE` Specifica l'ID per l'evento correlato a una modifica dello stato del pin.
`eMINIPORT_GET_STREAM_POSITION` Specifica l'ID per un evento "get stream position".
`eMINIPORT_SET_WAVERT_BUFFER_WRITE_POSITION` Specifica l'ID per un evento di "posizione di scrittura del buffer d'onda".
`eMINIPORT_GET_PRESENTATION_POSITION` Specifica l'ID per un evento "get presentation position".
`eMINIPORT_PROGRAM_DMA` Specifica l'ID per un evento "program DMA".
`eMINIPORT_GLITCH_REPORT` Specifica l'ID per un evento "report glitch".
`eMINIPORT_LAST_BUFFER_RENDERED` Specifica l'ID per l'ultimo buffer di cui è stato eseguito il rendering.
`eMINIPORT_PROCESSING_MODE` Specifica l'ID per la modalità di elaborazione applicata quando si è verificato l'errore.
`eMINIPORT_FX_CLSID` Specifica l'ID classe per l'effetto di elaborazione audio (FX) in vigore quando si è verificato l'errore.
`eMINIPORT_MaxValue` Specifica l'ID per il valore enumerato più alto utilizzato per segnalare l'interruzione.

Osservazioni

La tabella seguente illustra i membri dell'enumerazione EPcMiniportEngineEvent introdotta con Windows 8. La tabella mostra gli eventi associati ai membri dell'enumerazione e i significati dei relativi parametri.

Tipo di evento	Parametro 1	Parametro 2	Parametro 3	Parametro 4
Tipo di evento specifico di IHV.	Definito e usato da IHV.	Definito e usato da IHV.	Definito e usato da IHV.	Definito e usato da IHV.
Buffer completato.	Posizione corrente del buffer lineare.	Posizione di scrittura WaveRTBuffer corrente.	Lunghezza dei dati completata.	0
Aggiungi stato.	Posizione corrente del buffer lineare.	Posizione di scrittura WaveRTBuffer corrente.	0 - KS_STOP 1 - KS_ACQUIRE 2 - KS_PAUSE 3 - KS_RUN	0
Ottiene la posizione del flusso.	Posizione corrente del buffer lineare.	Posizione di scrittura WaveRTBuffer corrente.	0	0
Impostare la posizione di scrittura del buffer WaveRT.	Posizione corrente del buffer lineare.	Posizione di scrittura WaveRTBuffer corrente ricevuta da PortCls.	Posizione di scrittura WaveRTBuffer di destinazione ricevuta da PortCls.	0
Ottiene la posizione della presentazione.	Posizione corrente del buffer lineare.	Posizione di scrittura WaveRTBuffer corrente.	Posizione della presentazione.	0
DMA programma.	Posizione corrente del buffer lineare.	Posizione di scrittura WaveRTBuffer corrente.	Offset WaveRtBuffer iniziale	Lunghezza dei dati.
Rilevamento degli errori.	Posizione corrente del buffer lineare.	Posizione di scrittura WaveRTBuffer corrente.	1 - Buffer WaveRT in esecuzione 2 - Errori del decodificatore 3 - Ricevere la stessa posizione di scrittura del buffer WaveRT due volte in una riga.	Quando parametro 3 = '3' il parametro 4 è la posizione di scrittura che causa un errore.

La tabella seguente illustra i membri dell'enumerazione EPcMiniportEngineEvent introdotta con Windows 8.1. La tabella mostra gli eventi associati ai membri dell'enumerazione e i significati dei relativi parametri.

Tipo di evento	Parametro 1	Parametro 2	Parametro 3	Parametro 4
Ultimo buffer di cui è stato eseguito il rendering.	Posizione corrente del buffer lineare.	Ultima posizione di scrittura WaveRtBuffer ricevuta dal driver.	0	0
Modalità di elaborazione.	Posizione corrente del buffer lineare.	Posizione di scrittura WaveRTBuffer corrente.	Primi 8 byte di GUID.	Secondi 8 byte di GUID.
ID classe FX.	Posizione corrente del buffer lineare.	Posizione di scrittura WaveRTBuffer corrente.	Primi 8 byte di FX CLSID.	Secondi 8 byte di FX CLSID.
Valore massimo.	ID per il valore enumerato.	0	0	0

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8
server minimo supportato	Windows Server 2012
intestazione	portcls.h

Vedere anche

segnalazione degli errori per l' audio scaricato

miniportWriteEtwEvent

Condividi tramite