IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL(usbioctl.h)

아티클
02/26/2024

이 요청은 전송 특성의 변경 내용에 대한 알림을 등록합니다.

주 코드

입력/출력 버퍼

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