IOCTL_USB_USER_REQUEST IOCTL(usbuser.h)

아티클
08/26/2023

IOCTL_USB_USER_REQUEST I/O 제어 요청은 사용자 모드 애플리케이션과 커널 모드 드라이버 모두에서 사용할 수 있습니다.

IOCTL_USB_USER_REQUEST 사용자 모드 I/O 제어 요청입니다. 이 요청은 USB 호스트 컨트롤러(GUID_DEVINTERFACE_USB_HOST_CONTROLLER)를 대상으로 합니다.

호출자는 다음 요청 코드를 지정할 수 있습니다.

USBUSER_CLEAR_ROOTPORT_FEATURE: 이 요청을 사용하지 마세요.
USBUSER_GET_CONTROLLER_DRIVER_KEY: USB_UNICODE_NAME 형식의 유니코드 문자열에서 호스트 컨트롤러 드라이버 키를 보고합니다. 이 요청은 항상 사용하도록 설정됩니다.
USBUSER_GET_CONTROLLER_INFO_0: 호스트 컨트롤러를 설명하는 USB_CONTROLLER_INFO_0 구조를 검색합니다. 이 요청은 항상 사용하도록 설정됩니다.
USBUSER_GET_ROOTPORT_STATUS: 이 요청을 사용하지 마세요.
USBUSER_GET_ROOTHUB_SYMBOLIC_NAME: USB_UNICODE_NAME 형식의 유니코드 문자열에서 루트 허브 기호 이름을 보고합니다. 이 요청은 항상 사용하도록 설정됩니다.
USBUSER_INVALID_REQUEST: 이 요청을 사용하지 마세요.
USBUSER_OP_CLOSE_RAW_DEVICE: 이 요청을 사용하지 마세요.
USBUSER_OP_OPEN_RAW_DEVICE: 이 요청을 사용하지 마세요.
USBUSER_OP_MASK_DEVONLY_API: 이 요청을 사용하지 마세요.
USBUSER_OP_MASK_HCTEST_API: 이 요청을 사용하지 마세요.
USBUSER_OP_RAW_RESET_PORT: 이 요청을 사용하지 마세요.
USBUSER_OP_SEND_ONE_PACKET: 이 요청을 사용하지 마세요.
USBUSER_OP_SEND_RAW_COMMAND: 이 요청을 사용하지 마세요.
USBUSER_SET_ROOTPORT_FEATURE: 이 요청을 사용하지 마세요.
USBUSER_PASS_THRU: USB_PASS_THRU_PARAMETERS 구조로 정의된 공급업체별 명령을 호스트 컨트롤러 미니포트 드라이버로 보냅니다. 이 요청은 항상 사용하도록 설정됩니다.
USBUSER_GET_BANDWIDTH_INFORMATION: 할당된 대역폭에 대한 정보를 포함하는 USB_BANDWIDTH_INFO 구조를 검색합니다. 이 요청은 항상 사용하도록 설정됩니다.
USBUSER_GET_POWER_STATE_MAP: 호스트 컨트롤러 및 루트 허브의 전원 상태에 대한 정보를 포함하는 USB_POWER_INFO 구조를 검색합니다. 이 요청은 항상 사용하도록 설정됩니다.
USBUSER_GET_BUS_STATISTICS_0: 버스 통계를 포함하는 USB_BUS_STATISTICS_0 구조를 검색합니다. 이 요청은 항상 사용하도록 설정됩니다.
USBUSER_GET_BUS_STATISTICS_0_AND_RESET: 이 요청을 사용하지 마세요.
USBUSER_GET_USB_DRIVER_INFORMATION: 드라이버, USB 스택 및 연결된 인터페이스의 버전을 나타내는 USB_DRIVER_VERSION_PARAMETERS 구조를 검색합니다. 이 요청은 항상 사용하도록 설정됩니다.
USBUSER_GET_USB2_HW_VERSION: 이 요청을 사용하지 마세요.

입력 버퍼

Irp-AssociatedIrp.SystemBuffer>의 버퍼에는 요청을 정의하는 사용자 요청 헤더 구조(USBUSER_REQUEST_HEADER)가 포함되어 있습니다. 헤더 구조 다음에는 요청의 매개 변수를 보유하는 구조체가 있습니다. 각 요청에 해당하는 매개 변수 구조에 대한 자세한 내용은 각 요청에 대한 설명을 참조하세요.