KsStreamPointerLock 函式 (ks.h)
KsStreamPointerLock 函式會嘗試鎖定指定的數據流指標。
語法
KSDDKAPI NTSTATUS KsStreamPointerLock(
[in] PKSSTREAM_POINTER StreamPointer
);
參數
[in] StreamPointer
KSSTREAM_POINTER 結構的指標,表示嘗試鎖定的數據流指標。
傳回值
KsStreamPointerLock 會傳回STATUS_SUCCESS,指出數據流指標已鎖定或適當的錯誤碼。 STATUS_DEVICE_NOT_READY是指出框架無法鎖定的一般錯誤碼。 此錯誤碼通常表示 已取消 StreamPointer 指向的框架。
備註
鎖定的數據流指標可確保有與數據流指標相關聯的數據框架,而且只要維護鎖定,就不會取消此框架。 minidriver 應該先鎖定數據流指標,再嘗試存取數據流指標指向的數據。
如果數據流指標參考的針腳指定應該使用KSPIN_FLAG_GENERATE_MAPPINGS產生 DMA 散佈/收集對應,AVStream 會在串流指標鎖定時產生對應。
另請參閱 Stream指標。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Microsoft Windows XP 和更新版本的作業系統和 DirectX 8.0 和更新版本的 DirectX 版本。 |
目標平台 | Universal |
標頭 | ks.h (包含 Ks.h) |
程式庫 | Ks.lib |
IRQL | <=DISPATCH_LEVEL |