EPcMiniportEngineEvent-Aufzählung (portcls.h)

Artikel
02/07/2025

In diesem Thema wird die Enumeration "EPcMiniportEngineEvent" vorgestellt und die Parameter beschrieben, die zusätzliche Informationen bereitstellen, wenn der Miniport-Treiber einen Fehler meldet.

Die Ereignis-IDs in der folgenden Enumeration stellen Ereignisse dar, die der Miniporttreiber melden kann, indem Rückrufe über den Portklassentreiber (PortCls) verwendet werden.

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;

Konstanten


`eMINIPORT_IHV_DEFINED` Gibt die ID für ein IHV-definiertes Ereignis an.
`eMINIPORT_BUFFER_COMPLETE` Gibt die ID für das Puffervervollständigen-Ereignis an.
`eMINIPORT_PIN_STATE` Gibt die ID für das Ereignis an, das sich auf eine Änderung im Pin-Zustand bezieht.
`eMINIPORT_GET_STREAM_POSITION` Gibt die ID für ein "get stream position"-Ereignis an.
`eMINIPORT_SET_WAVERT_BUFFER_WRITE_POSITION` Gibt die ID für ein Ereignis vom Typ "Wellenpuffer-Schreibposition" an.
`eMINIPORT_GET_PRESENTATION_POSITION` Gibt die ID für ein Ereignis "Präsentationsposition abrufen" an.
`eMINIPORT_PROGRAM_DMA` Gibt die ID für ein "Programm-DMA"-Ereignis an.
`eMINIPORT_GLITCH_REPORT` Gibt die ID für ein "Glitch report"-Ereignis an.
`eMINIPORT_LAST_BUFFER_RENDERED` Gibt die ID für den letzten Puffer an, der gerendert wurde.
`eMINIPORT_PROCESSING_MODE` Gibt die ID für den Verarbeitungsmodus an, der beim Auftreten des Glitchs wirksam war.
`eMINIPORT_FX_CLSID` Gibt die Klassen-ID für den Audioverarbeitungseffekt (FX) an, der beim Auftreten des Glitchs wirksam war.
`eMINIPORT_MaxValue` Gibt die ID für den höchsten Aufzählungswert an, der zum Melden des Glitchs verwendet wurde.

Bemerkungen

In der folgenden Tabelle sind die Member der EPcMiniportEngineEvent-Enumeration aufgeführt, die mit Windows 8 eingeführt wurden. Die Tabelle zeigt die Ereignisse, die den Membern der Enumeration zugeordnet sind, und die Bedeutungen ihrer Parameter.

Ereignistyp	Parameter 1	Parameter 2	Parameter 3	Parameter 4
IHV-spezifischer Ereignistyp.	Definiert und verwendet von IHVs.	Definiert und verwendet von IHVs.	Definiert und verwendet von IHVs.	Definiert und verwendet von IHVs.
Puffer abgeschlossen.	Aktuelle lineare Pufferposition.	Aktuelle WaveRTBuffer-Schreibposition.	Die Datenlänge wurde abgeschlossen.	0
Pin-Zustand.	Aktuelle lineare Pufferposition.	Aktuelle WaveRTBuffer-Schreibposition.	0 - KS_STOP 1 - KS_ACQUIRE 2 - KS_PAUSE 3 - KS_RUN	0
Abrufen der Streamposition.	Aktuelle lineare Pufferposition.	Aktuelle WaveRTBuffer-Schreibposition.	0	0
Legen Sie die Schreibposition des WaveRT-Puffers fest.	Aktuelle lineare Pufferposition.	Aktuelle WaveRTBuffer-Schreibposition, die von PortCls empfangen wurde.	Ziel WaveRTBuffer-Schreibposition, die von PortCls empfangen wurde.	0
Präsentationsposition abrufen.	Aktuelle lineare Pufferposition.	Aktuelle WaveRTBuffer-Schreibposition.	Präsentationsposition.	0
Programm-DMA.	Aktuelle lineare Pufferposition.	Aktuelle WaveRTBuffer-Schreibposition.	WaveRtBuffer-Offset wird gestartet	Datenlänge.
Glitch-Erkennung.	Aktuelle lineare Pufferposition.	Aktuelle WaveRTBuffer-Schreibposition.	1 – WaveRT-Puffer wird ausgeführt 2 – Decoderfehler 3 – Empfangen der gleichen WaveRT-Pufferposition zweimal in einer Zeile.	Wenn Parameter 3 = '3' ist dann Parameter 4 die problematische Schreibposition.

In der folgenden Tabelle sind die Member der EPcMiniportEngineEvent-Enumeration aufgeführt, die mit Windows 8.1 eingeführt wurden. Die Tabelle zeigt die Ereignisse, die den Membern der Enumeration zugeordnet sind, und die Bedeutungen ihrer Parameter.

Ereignistyp	Parameter 1	Parameter 2	Parameter 3	Parameter 4
Letzter Puffer gerendert.	Aktuelle lineare Pufferposition.	Die letzte WaveRtBuffer-Schreibposition, die der Treiber erhalten hat.	0	0
Verarbeitungsmodus.	Aktuelle lineare Pufferposition.	Aktuelle WaveRTBuffer-Schreibposition.	Erste 8 Byte GUID.	Zweite 8 Byte GUID.
FX-Klassen-ID.	Aktuelle lineare Pufferposition.	Aktuelle WaveRTBuffer-Schreibposition.	Erste 8 Bytes FX CLSID.	Zweite 8 Bytes FX CLSID.
Max. Wert.	ID für aufgezählten Wert.	0	0	0

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8
mindestens unterstützte Server-	Windows Server 2012
Header-	portcls.h

Siehe auch

Glitch-Berichterstellung für offloaded Audio

MiniportWriteEtwEvent-

Freigeben über