Перечисление EPcMiniportEngineEvent (portcls.h)

Статья
02/07/2025

В этом разделе описывается перечисление EPcMiniportEngineEvent и описываются параметры, которые предоставляют дополнительные сведения, когда драйвер минипорта сообщает об ошибке сбоя.

Идентификаторы событий в приведенном ниже перечислении представляют события, которые может сообщать драйвер мини-порта, используя обратные вызовы с помощью драйвера класса порта (PortCls).

Синтаксис

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;

Константы


`eMINIPORT_IHV_DEFINED` Задает идентификатор для события, определенного IHV.
`eMINIPORT_BUFFER_COMPLETE` Указывает идентификатор для события завершения буфера.
`eMINIPORT_PIN_STATE` Указывает идентификатор события, связанного с изменением состояния пин-кода.
`eMINIPORT_GET_STREAM_POSITION` Указывает идентификатор события get stream position.
`eMINIPORT_SET_WAVERT_BUFFER_WRITE_POSITION` Указывает идентификатор события записи буфера волны.
`eMINIPORT_GET_PRESENTATION_POSITION` Указывает идентификатор события get presentation position.
`eMINIPORT_PROGRAM_DMA` Указывает идентификатор события DMA программы.
`eMINIPORT_GLITCH_REPORT` Указывает идентификатор события "сбой отчета".
`eMINIPORT_LAST_BUFFER_RENDERED` Указывает идентификатор последнего буфера, который был отрисован.
`eMINIPORT_PROCESSING_MODE` Указывает идентификатор для режима обработки, который был в действии при сбое.
`eMINIPORT_FX_CLSID` Указывает идентификатор класса для эффекта обработки звука (FX), который был в действии при сбое.
`eMINIPORT_MaxValue` Указывает идентификатор для наивысшего перечисленного значения, которое использовалось для сообщения о сбое.

Замечания

В следующей таблице показаны члены перечисления EPcMiniportEngineEvent, представленные в Windows 8. В таблице показаны события, связанные с элементами перечисления, и значения их параметров.

Тип события	Параметр 1	Параметр 2	Параметр 3	Параметр 4
Тип события IHV.	Определяется и используется IHV.	Определяется и используется IHV.	Определяется и используется IHV.	Определяется и используется IHV.
Полный буфер.	Текущая линейная позиция буфера.	Текущая позиция записи WaveRTBuffer.	Длина данных завершена.	0
Закрепление состояния.	Текущая линейная позиция буфера.	Текущая позиция записи WaveRTBuffer.	0 — KS_STOP 1 - KS_ACQUIRE 2 — KS_PAUSE 3 — KS_RUN	0
Получение положения потока.	Текущая линейная позиция буфера.	Текущая позиция записи WaveRTBuffer.	0	0
Задайте положение записи буфера WaveRT.	Текущая линейная позиция буфера.	Текущая позиция записи WaveRTBuffer, полученная из PortCls.	Позиция записи Target WaveRTBuffer, полученная из PortCls.	0
Получение позиции презентации.	Текущая линейная позиция буфера.	Текущая позиция записи WaveRTBuffer.	Позиция презентации.	0
Программа DMA.	Текущая линейная позиция буфера.	Текущая позиция записи WaveRTBuffer.	Начальная смещение WaveRtBuffer	Длина данных.
Обнаружение сбоя.	Текущая линейная позиция буфера.	Текущая позиция записи WaveRTBuffer.	1. Буфер WaveRT под запуском 2. Ошибки декодирования 3. Получение одной позиции записи буфера WaveRT дважды в строке.	Если параметр 3 = "3", то параметр 4 является обижающей позицией записи.

В следующей таблице показаны члены перечисления EPcMiniportEngineEvent, представленные в Windows 8.1. В таблице показаны события, связанные с элементами перечисления, и значения их параметров.

Тип события	Параметр 1	Параметр 2	Параметр 3	Параметр 4
Последняя отрисовка буфера.	Текущая линейная позиция буфера.	Самое последнее положение записи WaveRtBuffer, полученное драйвером.	0	0
Режим обработки.	Текущая линейная позиция буфера.	Текущая позиция записи WaveRTBuffer.	Первые 8 байт GUID.	Второй 8 байт GUID.
Идентификатор класса FX.	Текущая линейная позиция буфера.	Текущая позиция записи WaveRTBuffer.	Первые 8 байт FX CLSID.	Второй 8 байт FX CLSID.
Максимальное значение.	Идентификатор перечисленного значения.	0	0	0

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8
минимальный поддерживаемый сервер	Windows Server 2012
заголовка	portcls.h

См. также

Отчеты о глитчах для отключенных звуковых

MiniportWriteEtwEvent

Поделиться через