IOCTL_NFP_DISABLE IOCTL (nfpdev.h)

Artigo
03/01/2024

Um cliente envia a solicitação IOCTL_NFP_DISABLE para desabilitar temporariamente assinaturas, publicações e eventos de presença. Isso é útil quando um cliente deseja desabilitar a funcionalidade de proximidade, mas manter os recursos alocados para habilitá-los rapidamente quando necessário novamente.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Nenhum

Buffer de saída

Nenhum

Bloco de status

Irp-IoStatus.Status> será definido como STATUS_SUCCESS se a solicitação for bem-sucedida.

Caso contrário, Status para a condição de erro apropriada como um código NTSTATUS.

Para obter mais informações, consulte Valores NTSTATUS.

Comentários

Veja a seguir as ações necessárias ao usar este IOCTL:

Quando esse IOCTL é recebido, o driver DEVE marcar o identificador de arquivo como "Desabilitado".
Se um identificador de assinatura for alterado para "Desabilitado, o provedor DEVERÁ remover todas as mensagens da fila "Recebido" desse identificador de arquivo.
Se um identificador de assinatura for "Desabilitado":
- O driver DEVE manter a fila "Recebida" desse identificador com comprimento zero, limpando (soltando) mensagens existentes na fila e soltando novas mensagens da fila assim que elas forem recebidas.
- O driver DEVE concluir todas as solicitações de IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE pendentes nesse identificador com STATUS_CANCELLED.
Se um identificador de publicação for "Desabilitado", o provedor NÃO DEVERÁ transmitir a mensagem da publicação e deverá concluir todas as solicitações de IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE pendentes nesse identificador com STATUS_CANCELLED