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
Buffer di input
Nessuno
Buffer di output
Nessuno
Blocco di stato
Irp->IoStatus.Status è impostato su STATUS_SUCCESS se la richiesta ha esito positivo.
In caso contrario, stato della condizione di errore appropriata come codice NTSTATUS.
Per altre informazioni, vedere valori NTSTATUS.
Osservazioni
Quando si usa questo IOCTL, sono necessarie le azioni seguenti:
- 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" a lunghezza zero 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
Fabbisogno
Requisito | Valore |
---|---|
client minimo supportato | Windows 8 |
intestazione | nfpdev.h |
Vedere anche
guida di progettazione generale NFC (Near Field Communication)