KsStreamPointerAdvanceOffsets 函式 (ks.h)
KsStreamPointerAdvanceOffsets 函式會推進 StreamPointer 位移。
語法
KSDDKAPI NTSTATUS KsStreamPointerAdvanceOffsets(
[in] PKSSTREAM_POINTER StreamPointer,
[in] ULONG InUsed,
[in] ULONG OutUsed,
[in] BOOLEAN Eject
);
參數
[in] StreamPointer
KSSTREAM_POINTER 結構的指標,表示要前進位移的數據流指標。 呼叫此函式時,StreamPointer 應該處於鎖定狀態。
[in] InUsed
要前進此數據流指標之輸入指標的位元元組數目。
(StreamPointer -> OffsetIn)
[in] OutUsed
要前進此數據流指標輸出指標的位元元組數目
(StreamPointer -> OffsetOut)
[in] Eject
此參數會指出數據流指標是否應該進階至下一個數據框架。如果此參數設定為 TRUE,AVStream 會推進數據流指標,而不論推進位移是否會導致數據流指標指向框架的結尾。
傳回值
KsStreamPointerAdvanceOffsets 會在成功時傳回STATUS_SUCCESS。 如果 StreamPointer 在呼叫時未鎖定,或數據流指標在推進后無法鎖定,則傳回STATUS_DEVICE_NOT_READY。
言論
AVStream 會依要求的值,更新進出數據指標和其他相關欄位。 如果向前移動位移會導致目前框架中剩餘的位元組數為零,AVStream 會將數據流指標往前移至下一個數據框架,並重新鎖定它。
在呼叫 KsStreamPointerAdvanceOffsets之前,迷你驅動程式有責任先確認 StreamPointer 已鎖定。 此外,單一進階無法將數據流指標進一步提升至佇列中下一個框架的開頭。 因此,minidrivers 不應該嘗試將位移前移的值大於 StreamPointer -> Offset*。剩餘。
另請參閱 串流指標。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Microsoft Windows XP 和更新版本的作系統和 DirectX 8.0 和更新版本的 DirectX 版本中提供。 |
目標平臺 | 普遍 |
標頭 | ks.h (包括 Ks.h) |
連結庫 | Ks.lib |
IRQL | <=DISPATCH_LEVEL |