IOCTL_NFP_DISABLE IOCTL (nfpdev.h)

Articolo
02/07/2025

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 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