IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION IOCTL(usbioctl.h)

아티클
05/23/2024

IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 요청은 USB 포트 초고속 레인 정보를 검색합니다.

클라이언트 드라이버는 PASSIVE_LEVEL IRQL에서 이 IOCTL을 보내야 합니다.

IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 사용자 모드 I/O 제어 요청입니다. 이 요청은 USB 허브 디바이스(GUID_DEVINTERFACE_USB_HUB)를 대상으로 합니다.

주 코드

IRP_MJ_DEVICE_CONTROL

입력/출력 버퍼

입력 버퍼와 출력 버퍼는 모두 호출자가 할당한 USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 구조를 가리킵니다. 입력에서 이 구조체의 ConnectionIndex 멤버는 초고속 레인 정보를 보고할 포트 수를 나타내는 1보다 크거나 같은 숫자를 포함해야 합니다. 허브 드라이버는 USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 구조체의 나머지 멤버에 초고속 차선 정보를 반환합니다. IRP, AssociatedIrp.SystemBuffer 멤버는 USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 구조를 가리킵니다.

출력 시 USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 구조체는 USB 허브 드라이버에서 표시된 초고속 차선에 대한 정보를 받습니다.

입력/출력 버퍼 길이

USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 구조체의 크기입니다.

상태 블록

USB 스택은 요청이 성공하면 Irp-IoStatus.Status>를 STATUS_SUCCESS 설정합니다. 그렇지 않으면 USB 스택은 상태를 STATUS_INVALID_PARAMETER 또는 STATUS_INSUFFICIENT_RESOURCES 같은 적절한 오류 조건으로 설정합니다.

설명

다음은 USB 포트 초고속 레인 정보를 검색하는 방법을 보여 주는 예제입니다.

success = DeviceIoControl(hHubDevice,
                          IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION,
                          connectionSSPInfo,
                          sizeof(USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION),
                          connectionSSPInfo,
                          sizeof(USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION),
                          &nBytes,
                          NULL);

요구 사항

요구 사항	값
헤더	usbioctl.h

다음을 통해 공유