IOCTL_USB_GET_NODE_CONNECTION_NAME IOCTL(usbioctl.h)

IOCTL_USB_GET_NODE_CONNECTION_NAME I/O 컨트롤 요청은 USB_NODE_CONNECTION_NAME 구조와 함께 다운스트림 포트에 연결된 허브의 기호 링크 이름을 검색하는 데 사용됩니다.

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

주 코드

IRP_MJ_DEVICE_CONTROL

입력 버퍼

AssociatedIrp.SystemBuffer 멤버는 USB_NODE_CONNECTION_NAME 구조를 가리킵니다. 입력에서 이 구조체의 ConnectionIndex 멤버는 연결된 허브에 대해 검사 포트 수를 나타내야 합니다.

입력 버퍼 길이

USB_NODE_CONNECTION_NAME 구조체의 크기입니다.

출력 버퍼

AssociatedIrp.SystemBuffer는USB_NODE_CONNECTION_NAME 구조를 가리킵니다. 출력에서 이 구조체에는 HubName 멤버에 연결된 허브의 기호화된 이름이 포함됩니다. 허브가 연결되지 않았거나 허브에 기호 링크가 없거나 연결된 디바이스가 허브가 아닌 경우 HubName[0]에는 UNICODE_NULL 값이 포함됩니다.

출력 버퍼 길이

Parameters.DeviceIoControl.OutputBufferLength 멤버에는 전체 USB_NODE_CONNECTION_NAME 구조체의 크기(바이트)가 포함됩니다.

상태 블록

USB 스택은 요청이 성공하면 Irp-IoStatus.Status>를 STATUS_SUCCESS 설정합니다. 허브가 연결되지 않았거나, 연결된 허브에 기호 링크가 없거나, 연결된 디바이스가 허브가 아니더라도 요청은 성공을 보고합니다.

그렇지 않으면 USB 스택이 상태를 STATUS_INVALID_PARAMETER 또는 STATUS_INSUFFICIENT_RESOURCES 같은 적절한 오류 조건으로 설정합니다.

요구 사항

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

추가 정보

USB_NODE_CONNECTION_NAME