Метод 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 |