IOCTL_NFP_SET_PAYLOAD IOCTL (nfpdev.h)
Клиентское приложение отправляет данные сообщения и подтверждает публикацию с помощью запроса IOCTL_NFP_SET_PAYLOAD.
Основной код
Входной буфер
Входной буфер содержит данные сообщения для передачи.
Выходной буфер
Никакой.
Блок состояния
Irp->IoStatus.Status имеет значение STATUS_SUCCESS, если запрос выполнен успешно.
В противном случае состояние соответствующего условия ошибки в виде кода NTSTATUS.
Дополнительные сведения см. в значения NTSTATUS.
Замечания
При использовании этого IOCTL требуются следующие действия:
- Если этот IOCTL отправляется на дескриптор, который ранее не был открыт в "Pubs\..." имя файла, драйвер ДОЛЖЕН завершить работу с STATUS_INVALID_DEVICE_STATE.
- Данные сообщения записываются один раз. Если этот IOCTL выполнен один раз, все последующие IOCTL_NFP_SET_PAYLOAD, полученные на том же дескрипторе, должны быть завершены с STATUS_INVALID_DEVICE_STATE.
- Если IOCTL содержит выходной буфер, драйвер должен завершить IOCTL с STATUS_INVALID_PARAMETER.
- Если входной буфер превышает максимальный размер сообщения драйвера, драйвер должен завершить IOCTL с STATUS_INVALID_BUFFER_SIZE.
- Если любое устройство становится прокси-интерфейсом после успешного выполнения этого IOCTL, а перед закрытием дескриптора данные сообщения (вместе с его типом) должны передаваться только один раз на прокси-устройство.
- Если одно и то же (или другое) устройство снова становится прокси-матом перед закрытием дескриптора, сообщение должно быть передано еще раз.
- Если устройство в настоящее время является прокси-сервером при успешном завершении этого IOCTL, данные сообщения (вместе с типом) должны передаваться (только один раз) на прокси-устройство. Это применимо, даже если дескриптор немедленно закрыт.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 8 |
| заголовка | nfpdev.h |
См. также
общее руководство по проектированию по взаимодействию с полями (NFC)