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。 不成功的傳回狀態表示 釘選 沒有相關聯的佇列。
言論
非就地針腳應針對輸入針腳使用 InputDataBytes,並針對輸出釘選使用 OutputBufferBytes。
除非在呼叫時間保留處理 Mutex,否則此呼叫的結果不保證是安全的,或者呼叫端在呼叫例程之前已私下同步處理。 若要私下同步處理,請確定在例程執行時,針腳不會從 Acquire 轉換為 Stop。 請參閱在AVStream 中處理 Mutex。
另請注意,就地轉換可以提供輸入和輸出計數。
在 Windows XP 和 DirectX 8.0 中,除非篩選接收的畫面已滿,否則 InputDataBytes 計數無效。
如需詳細資訊,請參閱 前置和尾端邊緣串流指標。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Microsoft Windows XP 和更新版本的作系統和 DirectX 8.0 和更新版本的 DirectX 版本中提供。 |
目標平臺 | 普遍 |
標頭 | ks.h (包括 Ks.h) |
連結庫 | Ks.lib |
另請參閱
KsFilterAcquireProcessingMutex
KsFilterReleaseProcessingMutex
KsPinGetLeadingEdgeStreamPointer