KsStreamPointerAdvance 函式 (ks.h)
KsStreamPointerAdvance 函式會將數據流指標前進到下一個數據框架。
語法
KSDDKAPI NTSTATUS KsStreamPointerAdvance(
[in] PKSSTREAM_POINTER StreamPointer
);
參數
[in] StreamPointer
KSSTREAM_POINTER 結構的指標,表示要前進以參考下一個可用數據框架的數據流指標。
傳回值
KsStreamPointerAdvance 會傳回STATUS_SUCCESS,表示成功推進。 否則會傳回錯誤碼。 STATUS_DEVICE_NOT_READY是最常傳回的錯誤碼,而且通常表示在推進失敗后鎖定數據流指標。 換句話說,StreamPointer 參考佇列中的最後一個框架。
言論
如果 StreamPointer 在呼叫時鎖定,AVStream 會在推進之前解除鎖定它。 進階之後,串流指標就會回到新框架的原始狀態(鎖定或解除鎖定)。
嘗試推進解除鎖定的數據流指標一律會成功,並傳回STATUS_SUCCESS。 由於數據流指標未鎖定,因此無法判斷數據流指標是否參考實際數據。 迷你驅動程式必須嘗試鎖定,以判斷新進階數據流指標是否參考數據框架。
另請參閱 串流指標。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Microsoft Windows XP 和更新版本的作系統和 DirectX 8.0 和更新版本的 DirectX 版本中提供。 |
目標平臺 | 普遍 |
標頭 | ks.h (包括 Ks.h) |
連結庫 | Ks.lib |
IRQL | <=DISPATCH_LEVEL |