IOCTL_KS_RESET_STATE IOCTL (ks.h)
應用程式可以使用IOCTL_KS_RESET_STATE,將釘選傳回至在 Acquire 時間的狀態。 應用程式會將IOCTL_KS_RESET_STATE,並將下列參數傳遞給 KsSynchronousDeviceControl 函式。
主要程序代碼
輸入緩衝區
用戶端會提供緩衝區,其中包含 InBuffer 參數中的重設值 (KSRESET_BEGIN KSRESET_END) 。
輸入緩衝區長度
InLength 會指定輸入緩衝區內容的大小,以位元組為單位。
輸出緩衝區
無。
輸出緩衝區長度
無。
狀態區塊
如果要求成功,狀態成員會設定為 STATUS_SUCCESS。
備註
藉由在 KsSynchronousDeviceControl 的 InBuffer 參數中,以KSRESET_BEGIN值傳送IOCTL_KS_RESET_STATE,在針腳上起始重設。
起始重設狀態時,會取消現有的讀取和寫入要求。 處於重設狀態時,任何新的讀取或寫入要求都會遭到拒絕,STATUS_DEVICE_NOT_READY。
若要終止重設狀態,請使用 KSRESET_END 值傳送IOCTL_KS_RESET_STATE。
請注意,重設狀態不會藉由變更針腳狀態來取消。
當重設狀態終止時,針腳可以再次接受新的數據,並將數據傳遞至其他連線。
規格需求
需求 | 值 |
---|---|
標頭 | ks.h (包含 Ks.h) |