IOCTL_NFP_DISABLE IOCTL (nfpdev.h)

Un cliente envía la solicitud de IOCTL_NFP_DISABLE para deshabilitar temporalmente las suscripciones, las publicaciones y los eventos de presencia. Esto es útil cuando un cliente quiere deshabilitar la funcionalidad de proximidad, pero mantener los recursos asignados para volver a habilitarlos rápidamente cuando sea necesario de nuevo.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

Ninguno

Búfer de salida

Ninguno

Bloque de estado

Irp->IoStatus.Status se establece en STATUS_SUCCESS si la solicitud se realiza correctamente.

De lo contrario, status to the appropriate error condition as a NTSTATUS code.

Para obtener más información, vea valores NTSTATUS.

Observaciones

A continuación se muestran las acciones necesarias al usar este IOCTL:

• Cuando se recibe este IOCTL, el controlador DEBE marcar el identificador de archivo como "Deshabilitado".
• Si se cambia un identificador de suscripción a "Deshabilitado, el proveedor DEBE quitar todos los mensajes de la cola "Received" del identificador de archivo.
• Si un identificador de suscripción es "Disabled":
  • El controlador DEBE mantener la cola "Recibida" de ese controlador a una longitud cero purgando (quitando) los mensajes existentes en la cola y quitando los nuevos mensajes de la cola tan pronto como se reciban.
  • El controlador DEBE completar todas las solicitudes de IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE en lápiz en ese identificador con STATUS_CANCELLED.
• Si un identificador de publicación es "Disabled", el proveedor NO DEBE transmitir el mensaje de la publicación y DEBE completar todas las solicitudes de IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE en lápiz en ese identificador con STATUS_CANCELLED

Requisitos

Consulte también

IOCTL_NFP_ENABLE

guía de diseño general de comunicación de campo cercano (NFC)

guía de diseño de proximidad de campo cercano (Tap and Do, modelo de proveedor NFP, requisitos de controlador)