IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL(usbioctl.h)
이 요청은 전송 특성의 변경 내용에 대한 알림을 등록합니다.
주 코드
입력/출력 버퍼
ASSOCIATedIrp.SystemBuffer 멤버는 USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION 구조체에 대한 포인터입니다. 입력 시 클라이언트 드라이버는 ChangeNotificationInputFlags 멤버에서 플래그를 설정하여 드라이버가 관심 있는 알림 변경 유형을 지정할 수 있습니다.
출력 시 구조체는 전송 특성의 등록 핸들 및 초기 값으로 채워집니다.
입력/출력 버퍼 길이
USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION 구조체의 크기입니다.
상태 블록
요청이 성공하면 Irp->IoStatus.Status가 STATUS_SUCCESS 설정됩니다. 그렇지 않으면 상태는 적절한 오류 조건을 NTSTATUS 코드로 나타냅니다.
설명
MA-USB 매체의 전송 특성은 시간이 지남에 따라 크게 달라질 수 있습니다. 클라이언트 다이버가 항상 최신 정보를 알고자 하는 경우 드라이버는 요청을 전송하여 알림을 등록해야 합니다.
이 요청은 사용자 모드 애플리케이션, UMDF 드라이버 또는 KMDF 드라이버에서 보낼 수 있습니다. USB 드라이버 스택은 부실 및 잘못된 등록 핸들을 확인합니다. 등록 전과 등록 취소 후 핸들에서 요청을 받으면 드라이버 스택이 요청에 실패합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 10, 버전 1709 |
| 지원되는 최소 서버 | Windows Server 2016 |
| 헤더 | usbioctl.h |
| IRQL | <=DISPATCH_LEVEL |
참고 항목
Media-Agnostic(MA-USB)용 USB 클라이언트 드라이버
WdfIoTargetSendInternalIoctlOthersSynchronously
피드백
다음에 대한 사용자 의견 제출 및 보기