KsPinGetAvailableByteCount 函式 (ks.h)

發行項
02/26/2024

KsPinGetAvailableByteCount 例程會輸出前置邊緣前的輸入數據位元組數目，以及前置邊緣前的輸出緩衝區位元組數目，這兩者都是針對呼叫端指定針腳的佇列。

語法

KSDDKAPI NTSTATUS KsPinGetAvailableByteCount(
  [in]            PKSPIN Pin,
  [out, optional] PLONG  InputDataBytes,
  [out, optional] PLONG  OutputBufferBytes
);

參數

[in] Pin

要為其計算這些佇列參數之 KSPIN 結構的指標。

[out, optional] InputDataBytes

LONG 值的指標，此例程會傳回前置邊緣前面的輸入數據位元組數目。若未要求此值，呼叫端會設定為 NULL 。

[out, optional] OutputBufferBytes

LONG 值的指標，此例程會傳回前置邊緣前面的輸出緩衝區位元組數目。若未要求此值，呼叫端會設定為 NULL 。

傳回值

如果已擷取要求的計數 () ，則傳回STATUS_SUCCESS。失敗的傳回狀態表示 Pin 沒有相關聯的佇列。

備註

非位置的針腳應該使用 InputDataBytes 進行輸入釘選，而 OutputBufferBytes 則用於輸出針腳。

除非在呼叫時保留處理 mutex，或呼叫端在呼叫例程之前私下同步處理，否則此呼叫的結果不保證為安全。若要進行私用同步處理，請確定針腳在執行例程時，不會從 Acquire 轉換為 Stop。請參閱在 AVStream 中處理 Mutex。

另請注意，就地轉換可以提供輸入和輸出計數。

在 Windows XP 和 DirectX 8.0 中，除非篩選收到的畫面已滿， 否則 InputDataBytes 計數無效。

如需詳細資訊，請參閱前置和尾端邊緣 Stream 指標。

規格需求

需求	值
最低支援的用戶端	適用於 Microsoft Windows XP 和更新版本的作業系統和 DirectX 8.0 和更新版本的 DirectX。
目標平台	Universal
標頭	ks.h (包含 Ks.h)
程式庫	Ks.lib