Edit

IOCTL_NFP_DISABLE IOCTL (nfpdev.h)

  • Article

A client sends the IOCTL_NFP_DISABLE request to temporarily disable subscriptions, publications, and presence events. This is useful when a client wants to disable the proximity functionality but keep the resources allocated to quickly re-enable them when needed again.

Major code

IRP_MJ_DEVICE_CONTROL

Input buffer

None

Output buffer

None

Status block

Irp->IoStatus.Status is set to STATUS_SUCCESS if the request is successful.

Otherwise, Status to the appropriate error condition as a NTSTATUS code.

For more information, see NTSTATUS Values.

Remarks

The following are required actions when using this IOCTL:

  • When this IOCTL is received the driver MUST mark the file handle as “Disabled”.
  • If a subscription handle is changed to “Disabled, the provider MUST remove all messages from that file handle’s “Received” queue.
  • If a subscription handle is “Disabled”:
    • The driver MUST keep that handle’s “Received” queue at zero length by purging (dropping) existing messages in the queue and by dropping new messages from the queue as soon as they are received.
    • The driver MUST complete all pended IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE requests on that handle with STATUS_CANCELLED.
  • If a publication handle is “Disabled”, the provider MUST NOT transmit the publication’s message and it MUST complete all pended IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE requests on that handle with STATUS_CANCELLED

Requirements

Requirement Value
Minimum supported client Windows 8
Header nfpdev.h

See also

IOCTL_NFP_ENABLE

Near field communication (NFC) overall design guide

Near field proximity design guide (Tap and Do, NFP provider model, driver requirements)