IOCTL_NFP_DISABLE IOCTL (nfpdev.h)
用戶端會傳送 IOCTL_NFP_DISABLE 要求,以暫時停用訂閱、發行集和目前狀態事件。 當用戶端想要停用鄰近功能時,這會很有用,但請保留配置的資源,以便在需要時再次重新啟用它們。
主要程序代碼
輸入緩衝區
沒有
輸出緩衝區
沒有
狀態區塊
Irp->如果要求成功,IoStatus.Status 會設定為STATUS_SUCCESS。
否則,狀態為適當的錯誤條件作為NTSTATUS程式碼。
如需詳細資訊,請參閱 NTSTATUS 值。
言論
以下是使用此 IOCTL 時的必要動作:
- 收到此 IOCTL 時,驅動程式必須將檔句柄標示為「已停用」。
- 如果訂用帳戶句柄變更為「已停用」,提供者必須從該檔案句柄的「已接收」佇列中移除所有訊息。
-
如果訂用帳戶句柄為 「已停用」:
- 驅動程式必須透過清除佇列中現有的訊息,並在收到新訊息後立即從佇列中卸除新訊息,以零長度保留該句柄的「已接收」佇列。
- 驅動程式必須使用 STATUS_CANCELLED 完成該句柄上的所有畫筆 IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE 要求。
- 如果發行集句柄為「已停用」,則提供者「不得」傳輸出版物的訊息,且必須完成該句柄上具有STATUS_CANCELLED的所有畫筆 IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE 要求
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 8 |
標頭 | nfpdev.h |