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


Метод IPortWavePciStream::TerminatePacket (portcls.h)

Метод TerminatePacket завершает текущий сопоставленный пакет.

Синтаксис

NTSTATUS TerminatePacket();

Возвращаемое значение

TerminatePacket возвращает STATUS_SUCCESS, если вызов был успешным. В противном случае метод возвращает соответствующий код ошибки.

Комментарии

Этот метод используется в основном для ситуаций записи, в которых пакеты ввода-вывода должны заканчиваться в определенных точках потока (например, для синхронизации с видеокадрами). Буфер данных для контакта записи на звуковом устройстве состоит из одного или нескольких пакетов ввода-вывода. Каждый пакет ввода-вывода — это часть буфера данных, подключенная к определенному IRP сопоставления. По умолчанию, когда поток записи находится в состоянии KSSTATE_RUN, содержимое пакета ввода-вывода становится доступным для клиента только после заполнения последнего сопоставления в пакете. Метод TerminatePacket немедленно делает частично заполненный пакет доступным для клиента, не дожидаясь дополнительных данных записи.

При изменении состояния потока записи с KSSTATE_RUN на KSSTATE_STOP автоматически завершается текущий пакет ввода-вывода.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть portcls.h (включая Portcls.h)
IRQL <=DISPATCH_LEVEL