IOCTL_NFP_SET_PAYLOAD IOCTL(nfpdev.h)
클라이언트 애플리케이션은 메시지 데이터를 보내고 IOCTL_NFP_SET_PAYLOAD 요청을 사용하여 게시를 확인합니다.
주 코드
입력 버퍼
입력 버퍼에는 전송할 메시지 데이터가 포함됩니다.
출력 버퍼
없음
상태 블록
요청이 성공하면 Irp-IoStatus.Status>가 STATUS_SUCCESS 설정됩니다.
그렇지 않으면 NTSTATUS 코드로 적절한 오류 조건에 대한 상태입니다.
자세한 내용은 NTSTATUS 값을 참조하세요.
설명
이 IOCTL을 사용하는 경우 다음 작업이 필요합니다.
- 이 IOCTL이 이전에 "Pubs\..."에서 열리지 않은 핸들로 전송되는 경우 filename, 드라이버는 STATUS_INVALID_DEVICE_STATE 완료해야 합니다.
- 메시지 데이터는 한 번 기록됩니다. 이 IOCTL이 한 번 성공하면 동일한 핸들에서 받은 후속 IOCTL_NFP_SET_PAYLOAD STATUS_INVALID_DEVICE_STATE 완료해야 합니다.
- IOCTL에 출력 버퍼가 포함된 경우 드라이버는 STATUS_INVALID_PARAMETER 사용하여 IOCTL을 완료해야 합니다.
- 입력 버퍼가 드라이버의 최대 메시지 크기보다 큰 경우 드라이버는 STATUS_INVALID_BUFFER_SIZE IOCTL을 완료해야 합니다.
- 이 IOCTL이 성공한 후 핸들을 닫기 전에 디바이스가 근접하게 되는 경우 메시지 데이터(해당 형식과 함께)는 근접 디바이스로 한 번만 전송되어야 합니다.
- 핸들을 닫기 전에 동일한(또는 다른) 디바이스가 다시 근접하게 되면 메시지를 다시 한 번 전송해야 합니다.
- 이 IOCTL이 성공적으로 완료될 때 디바이스가 현재 근접한 경우 메시지 데이터(해당 형식과 함께)를 근접 디바이스로 한 번만 전송해야 합니다. 핸들이 즉시 닫혀 있는 경우에도 적용됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 |
| 머리글 | nfpdev.h |