IOCTL_NFP_DISABLE IOCTL (nfpdev.h)
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 novamente rapidamente quando necessário novamente.
Código principal
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.
Observações
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 estiver "Desabilitado":
- O driver DEVE manter a fila "Recebida" desse identificador em comprimento zero, limpando (soltando) mensagens existentes na fila e soltando novas mensagens da fila assim que 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 estiver "Desabilitado", o provedor NÃO DEVERÁ transmitir a mensagem da publicação e deverá concluir todas as solicitações pendentes IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE nesse identificador com STATUS_CANCELLED
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 8 |
| cabeçalho | nfpdev.h |
Consulte também
guia de design geral da NFC (comunicação de campo próximo)