IOCTL_NFP_DISABLE IOCTL (nfpdev.h)

用戶端會傳送 IOCTL_NFP_DISABLE 要求，暫時停用訂閱、發行集和目前狀態事件。當用戶端想要停用鄰近功能時，這會很有用，但請保留配置的資源，以在需要時再次重新啟用它們。

無

無

如果要求成功，Irp-IoStatus.Status> 會設定為 STATUS_SUCCESS。

否則，狀態為適當的錯誤狀況為NTSTATUS程式碼。

如需詳細資訊，請參閱 NTSTATUS值。

備註

以下是使用此 IOCTL 時的必要動作：

收到此 IOCTL 時，驅動程式必須將檔案句柄標示為「已停用」。
如果訂用帳戶句柄變更為「已停用」，提供者必須從該檔案句柄的「已接收」佇列中移除所有訊息。
如果訂用帳戶句柄為「已停用」：
- 驅動程式必須保留該句柄的「已接收」佇列，方法是清除 () 卸除佇列中的現有訊息，並在收到新訊息後立即從佇列中卸除。
- 驅動程式必須在該句柄上完成所有畫筆 IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE 要求，並搭配STATUS_CANCELLED。
如果發行集句柄為「已停用」，提供者「不得」傳輸出版物的訊息，且必須完成該句柄上所有畫筆 IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE要求，並搭配STATUS_CANCELLED