共用方式為


KsStreamPointerAdvanceOffsets 函式 (ks.h)

KsStreamPointerAdvanceOffsets 函式會推進 StreamPointer 位移。

語法

KSDDKAPI NTSTATUS KsStreamPointerAdvanceOffsets(
  [in] PKSSTREAM_POINTER StreamPointer,
  [in] ULONG             InUsed,
  [in] ULONG             OutUsed,
  [in] BOOLEAN           Eject
);

參數

[in] StreamPointer

KSSTREAM_POINTER 結構的指標,表示要前進位移的數據流指標。 呼叫此函式時,StreamPointer 應該處於鎖定狀態。

[in] InUsed

要前進此數據流指標之輸入指標的位元元組數目。

(StreamPointer -> OffsetIn)

[in] OutUsed

要前進此數據流指標輸出指標的位元元組數目

(StreamPointer -> OffsetOut)

[in] Eject

此參數會指出數據流指標是否應該進階至下一個數據框架。如果此參數設定為 TRUE,AVStream 會推進數據流指標,而不論推進位移是否會導致數據流指標指向框架的結尾。

傳回值

KsStreamPointerAdvanceOffsets 會在成功時傳回STATUS_SUCCESS。 如果 StreamPointer 在呼叫時未鎖定,或數據流指標在推進后無法鎖定,則傳回STATUS_DEVICE_NOT_READY。

言論

AVStream 會依要求的值,更新進出數據指標和其他相關欄位。 如果向前移動位移會導致目前框架中剩餘的位元組數為零,AVStream 會將數據流指標往前移至下一個數據框架,並重新鎖定它。

在呼叫 KsStreamPointerAdvanceOffsets之前,迷你驅動程式有責任先確認 StreamPointer 已鎖定。 此外,單一進階無法將數據流指標進一步提升至佇列中下一個框架的開頭。 因此,minidrivers 不應該嘗試將位移前移的值大於 StreamPointer -> Offset*。剩餘

另請參閱 串流指標

要求

要求 價值
最低支援的用戶端 Microsoft Windows XP 和更新版本的作系統和 DirectX 8.0 和更新版本的 DirectX 版本中提供。
目標平臺 普遍
標頭 ks.h (包括 Ks.h)
連結庫 Ks.lib
IRQL <=DISPATCH_LEVEL

另請參閱

KsStreamPointerAdvance

KsStreamPointerAdvanceOffsetsAndUnlock

KsStreamPointerLock

KsStreamPointerUnlock