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

另請參閱

KSSTREAM_POINTER

KsStreamPointerAdvanceOffsets

KsStreamPointerAdvanceOffsetsAndUnlock

KsStreamPointerLock

KsStreamPointerUnlock