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 |