KsPinGetLeadingEdgeStreamPointer 函式 (ks.h)
KsPinGetLeadingEdgeStreamPointer 函式會取得與指定針腳相關聯之佇列的前置邊緣數據流指標。
語法
KSDDKAPI PKSSTREAM_POINTER KsPinGetLeadingEdgeStreamPointer(
[in] PKSPIN Pin,
[in] KSSTREAM_POINTER_STATE State
);
參數
[in] Pin
KSPIN 結構的指標，其擁有應取得前置邊緣數據流指標的佇列。
[in] State
此參數會指定如何取得前置邊緣數據流指標。 可以是下列其中一項：
KSSTREAM_POINTER_STATE_UNLOCKED
不論它是否參考數據框架，都取得前置邊緣數據流指標。
在鎖定指標之前，無法嘗試存取任何與指標相關聯的數據。 另請注意，與解除鎖定數據流指標相關聯的框架可以取消。
KSSTREAM_POINTER_STATE_LOCKED
取得並鎖定前置邊緣數據流指標。 如果沒有數據框架與數據流指標相關聯，則傳回 NULL。 如果傳回非Null 指標，則它是鎖定的數據流指標，且具有與其相關聯的數據框架。 無法取消與鎖定數據流指標相關聯的框架。
傳回值
KsPinGetLeadingEdgeStreamPointer 會傳回 KSSTREAM_POINTER 結構或 NULL 的指標。 NULL 的傳回值可能會發生，因為沒有與針腳相關聯的佇列，表示針腳不使用標準傳輸機制。 或者， 可能會發生 NULL 的傳回值，因為嘗試鎖定前置邊緣失敗，表示沒有與前置邊緣相關聯的數據框架。
備註
實作 釘選中心處理 的篩選條件通常會呼叫 KsPinGetLeadingEdgeStreamPointer。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Microsoft Windows XP 和更新版本的作業系統和 DirectX 8.0 和更新版本的 DirectX。 |
| 目標平台 | Universal |
| 標頭 | ks.h (包含 Ks.h) |
| 程式庫 | Ks.lib |
| IRQL | <=DISPATCH_LEVEL |
另請參閱
KsPinGetTrailingEdgeStreamPointer