Compartilhar via


IOCTL_NFP_GET_MAX_MESSAGE_BYTES IOCTL (nfpdev.h)

Um cliente envia a solicitação de IOCTL_NFP_GET_MAX_MESSAGE_BYTES para qualquer identificador genérico, um que não seja publicado e não assinado, para o dispositivo do provedor para determinar o tamanho máximo da mensagem com suporte.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Nenhum

Buffer de saída

Um valor INT32 que define o tamanho máximo da mensagem compatível com o fornecido.

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

  • Cada implementação do provedor pode especificar um tamanho máximo de mensagem para publicações e assinaturas. O Windows exige que esse tamanho máximo de mensagem com suporte do provedor não seja inferior a 10 KB.
  • A seguir estão as ações necessárias ao usar este ioctl:
    • O driver DEVE dar suporte a um tamanho máximo de mensagem não menor que 10 KB.
    • Quando esse IOCTL é recebido, o driver DEVE copiar o tamanho máximo da mensagem para o buffer de saída e concluí-lo com STATUS_SUCCESS.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Cabeçalho nfpdev.h

Confira também

Guia de design geral de NFC (comunicação a curta distância)

Guia de design de proximidade de campo próximo (Toque e Fazer, modelo de provedor NFP, requisitos de driver)