Partilhar via


IOCTL_NFP_GET_MAX_MESSAGE_BYTES IOCTL (nfpdev.h)

Um cliente envia a solicitação IOCTL_NFP_GET_MAX_MESSAGE_BYTES para qualquer identificador genérico, que não seja publicado e não assinado, para o dispositivo de 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 int32 valor 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.

Observações

  • 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 mensagens com suporte para o provedor não seja inferior a 10 KB.
  • Veja a seguir 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
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)

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