IOCTL_NFP_DISABLE IOCTL (nfpdev.h)

Un client invia la richiesta di IOCTL_NFP_DISABLE per disabilitare temporaneamente sottoscrizioni, pubblicazioni ed eventi di presenza. Ciò è utile quando un client vuole disabilitare la funzionalità di prossimità, ma mantenere le risorse allocate per riabilitarle rapidamente quando necessario.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Nessuno

Buffer di output

Nessuno

Blocco dello stato

Irp-IoStatus.Status> è impostato su STATUS_SUCCESS se la richiesta ha esito positivo.

In caso contrario, stato alla condizione di errore appropriata come codice NTSTATUS.

Per altre informazioni, vedere Valori NTSTATUS.

Commenti

Di seguito sono riportate le azioni necessarie quando si usa questo IOCTL:

• Quando questo IOCTL viene ricevuto, il driver DEVE contrassegnare l'handle di file come "Disabilitato".
• Se un handle di sottoscrizione viene modificato in "Disabilitato, il provider DEVE rimuovere tutti i messaggi dalla coda "Ricevuta" dell'handle di file.
• Se un handle di sottoscrizione è "Disabled":
  • Il driver DEVE mantenere la coda "Ricevuta" dell'handle a lunghezza zero eliminando (eliminando) i messaggi esistenti nella coda e rilasciando nuovi messaggi dalla coda non appena vengono ricevuti.
  • Il driver DEVE completare tutte le richieste di IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE penna su tale handle con STATUS_CANCELLED.
• Se un handle di pubblicazione è "Disabled", il provider NON DEVE trasmettere il messaggio della pubblicazione e DEVE completare tutte le richieste di IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE penna su tale handle con STATUS_CANCELLED

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Intestazione	nfpdev.h

Vedi anche

IOCTL_NFP_ENABLE

Guida generale alla comunicazione sul campo vicino (NFC)

Guida alla progettazione di prossimità nei campi (tocco e do, modello di provider NFP, requisiti del driver)