共用方式為


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

另請參閱

KSSTREAM_POINTER

KsStreamPointerAdvanceOffsets

KsStreamPointerAdvanceOffsetsAndUnlock

KsStreamPointerLock

KsStreamPointerUnlock