IOCTL_NFP_DISABLE IOCTL(nfpdev.h)

아티클
02/26/2024

클라이언트는 구독, 게시 및 현재 상태 이벤트를 일시적으로 사용하지 않도록 설정하는 IOCTL_NFP_DISABLE 요청을 보냅니다. 이는 클라이언트가 근접 기능을 사용하지 않도록 설정하려고 하지만 리소스를 할당된 상태로 유지하여 필요할 때 신속하게 다시 사용하도록 설정하려는 경우에 유용합니다.

주 코드

IRP_MJ_DEVICE_CONTROL

입력 버퍼

없음

출력 버퍼

없음

상태 블록

요청이 성공하면 Irp-IoStatus.Status>가 STATUS_SUCCESS 설정됩니다.

그렇지 않으면 NTSTATUS 코드로 적절한 오류 조건에 대한 상태입니다.

자세한 내용은 NTSTATUS 값을 참조하세요.

설명

이 IOCTL을 사용할 때 필요한 작업은 다음과 같습니다.

이 IOCTL이 수신되면 드라이버는 파일 핸들을 "사용 안 함"으로 표시해야 합니다.
구독 핸들이 "사용 안 함"으로 변경되면 공급자는 해당 파일 핸들의 "수신됨" 큐에서 모든 메시지를 제거해야 합니다.
구독 핸들이 "사용 안 함"인 경우:
- 드라이버는 큐에 있는 기존 메시지를 제거(삭제)하고 수신되는 즉시 큐에서 새 메시지를 삭제하여 해당 핸들의 "수신됨" 큐를 0 길이로 유지해야 합니다.
- 드라이버는 STATUS_CANCELLED 사용하여 해당 핸들에 대해 보류 중인 모든 IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE 요청을 완료해야 합니다.
게시 핸들이 "사용 안 함"인 경우 공급자는 게시의 메시지를 전송하지 않아야 하며 해당 핸들에서 보류 중인 모든 IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE 요청을 완료해야 합니다STATUS_CANCELLED