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 数据包。

要求