Функция обратного вызова PFNKSREMOVEEVENT (ks.h)
Подпрограмма AVStrMiniRemoveEvent minidriver avStream вызывается, когда клиент запрашивает удаление события из очереди уведомлений. Эта подпрограмма является необязательной.
Синтаксис
PFNKSREMOVEEVENT Pfnksremoveevent;
void Pfnksremoveevent(
[in] PFILE_OBJECT FileObject,
[in] _KSEVENT_ENTRY *EventEntry
)
{...}
Параметры
[in] FileObject
Указатель на объект файла, для которого требуется удалить событие.
[in] EventEntry
Указатель на структуру KSEVENT_ENTRY , созданную AVStream.
Возвращаемое значение
None
Remarks
Мини-driver указывает адрес этой подпрограммы в элементе RemoveHandlerструктуры KSEVENT_ITEM . Обработка событий в AVStream описывает, как мини-драйвер предоставляет эту структуру драйверу класса.
Если мини-driver предоставляет avStrMiniRemoveEvent и либо не указывает AddHandler , либо указывает AddHandler , который вызывает KsXxxAddEvent, то AVStrMiniRemoveEvent мини-драйвера должен вызвать RemoveEntryList с указателем на структуру LIST_ENTRY в структуре KSEVENT_ENTRY :
&EventEntry -> ListEntry
В противном случае avStrMiniRemoveEvent должно отменить действия, выполненные в AddHandler.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версиях. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | ks.h (включая Ks.h) |