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