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。 由於數據流指標未鎖定，因此無法判斷數據流指標是否參考實際數據。 迷你驅動程式必須嘗試鎖定，以判斷新進階數據流指標是否參考數據框架。
另請參閱 Stream指標。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Microsoft Windows XP 和更新版本的作業系統和 DirectX 8.0 和更新版本的 DirectX。 |
| 目標平台 | Universal |
| 標頭 | ks.h (包含 Ks.h) |
| 程式庫 | Ks.lib |
| IRQL | <=DISPATCH_LEVEL |