共用方式為


IOCTL_NFP_DISABLE IOCTL (nfpdev.h)

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

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

沒有

輸出緩衝區

沒有

狀態區塊

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

另請參閱

IOCTL_NFP_ENABLE

近距離通信(NFC)整體設計指南

近距離鄰近設計指南(點選和 Do、NFP 提供者模型、驅動程式需求)