IPortWavePciStream::TerminatePacket 方法 (portcls.h)

方法 TerminatePacket 终止当前正在映射的数据包。

语法

NTSTATUS TerminatePacket();

返回值

TerminatePacket 如果调用成功,则返回STATUS_SUCCESS。 否则,该方法将返回相应的错误代码。

注解

此方法主要用于捕获 I/O 数据包需要在流 (的特定点结束的情况,例如,) 与视频帧同步。 音频设备上的捕获引脚的数据缓冲区由一个或多个 I/O 数据包组成。 每个 I/O 数据包都是附加到特定映射 IRP 的数据缓冲区部分。 默认情况下,当捕获流处于KSSTATE_RUN状态时,只有在填充数据包中的最后一个映射时,I/O 数据包的内容才对客户端可用。 方法 TerminatePacket 使部分填充的数据包立即可供客户端使用,而无需等待其他捕获数据。

将捕获流的状态从 KSSTATE_RUN 更改为 KSSTATE_STOP 会自动终止当前 I/O 数据包。

要求

要求
目标平台 通用
标头 portcls.h (包括 Portcls.h)
IRQL <=DISPATCH_LEVEL