IPortWavePciStream::TerminatePacket 方法 (portcls.h)
方法 TerminatePacket
會終止目前正在對應的封包。
Syntax
NTSTATUS TerminatePacket();
傳回值
TerminatePacket
如果呼叫成功,則會傳回STATUS_SUCCESS。 否則,方法會傳回適當的錯誤碼。
備註
這個方法主要用於擷取情況,例如,I/O 封包必須在數據流的特定點結束 (,例如,與視訊畫面同步處理) 。 音訊裝置上擷取針腳的數據緩衝區包含一或多個 I/O 封包。 每個 I/O 封包都是附加至特定對應 IRP 的數據緩衝區部分。 根據預設,當擷取數據流處於KSSTATE_RUN狀態時,只有在封包中最後一個對應已填滿時,用戶端才能使用I/O 封包的內容。 方法 TerminatePacket
可讓用戶端立即使用部分填滿的封包,而不需要等待其他擷取數據。
將擷取數據流的狀態從KSSTATE_RUN變更為KSSTATE_STOP會自動終止目前的 I/O 封包。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | portcls.h (包括 Portcls.h) |
IRQL | <=DISPATCH_LEVEL |