IOCTL_USB_GET_ROOT_HUB_NAME IOCTL(usbioctl.h)

  • 아티클

IOCTL_USB_GET_ROOT_HUB_NAME I/O 컨트롤 요청은 루트 허브의 기호 링크 이름을 검색하기 위해 USB_ROOT_HUB_NAME 구조체와 함께 사용됩니다.

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

주 코드

IRP_MJ_DEVICE_CONTROL

입력 버퍼

없음

입력 버퍼 길이

없음

출력 버퍼

출력에서 ASSOCIATedIrp.SystemBuffer 멤버는 루트 허브의 기호 링크 이름이 포함된 USB_ROOT_HUB_NAME 구조를 가리킵니다. 선행 "\xxx\ " 텍스트는 검색된 문자열에 포함되지 않습니다.

출력 버퍼 길이

USB_ROOT_HUB_NAME 구조체의 크기입니다.

상태 블록

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

루트 허브가 제거되거나 중지되면 요청은 STATUS_SUCCESS 반환하지만 문자열은 NULL입니다.

요구 사항

요구 사항 값
헤더 usbioctl.h(Usbioctl.h 포함)

추가 정보

USB_ROOT_HUB_NAME