IOCTL_USB_GET_NODE_CONNECTION_INFORMATION IOCTL(usbioctl.h)

IOCTL_USB_GET_NODE_CONNECTION_INFORMATION 요청은 표시된 USB 포트 및 포트에 연결된 디바이스(있는 경우)에 대한 정보를 검색합니다.

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

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

주 코드

IRP_MJ_DEVICE_CONTROL

입력 버퍼

ASSOCIATedIrp.SystemBuffer 멤버는 연결을 설명하는 사용자가 할당한 USB_NODE_CONNECTION_INFORMATION 구조를 가리킵니다. 입력에서 이 구조체의 ConnectionIndex 멤버에는 포트 번호가 포함됩니다.

입력 버퍼 길이

USB_NODE_CONNECTION_INFORMATION 구조체의 크기입니다.

출력 버퍼

출력 시 Parameters.DeviceIoControl.OutputBufferLength 멤버에는 출력 데이터의 크기가 포함됩니다. 이 크기는 포트와 연결된 파이프 수에 따라 달라지므로 가변적입니다.

ASSOCIATedIrp.SystemBuffer 는 출력 데이터가 포함된 사용자가 할당한 USB_NODE_CONNECTION_INFORMATION 구조를 가리킵니다.

출력 버퍼 길이

USB_NODE_CONNECTION_INFORMATION 구조체의 크기입니다.

상태 블록

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

설명

IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX 요청은 확장된 버전의 IOCTL_USB_GET_NODE_CONNECTION_INFORMATION. 요청의 확장된 버전이 낮음, 전체 및 고속 연결을 보고할 수 있고 이전 IOCTL_USB_GET_NODE_CONNECTION_INFORMATION 요청은 낮음 및 전체 속도 연결만 보고한다는 점을 제외하고 두 요청은 동일합니다. 이러한 두 요청 간의 차이점에 대한 자세한 내용은 USB_NODE_CONNECTION_INFORMATION 및 USB_NODE_CONNECTION_INFORMATION_EX 참조하세요.

요구 사항

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

추가 정보

IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX

USB_NODE_CONNECTION_INFORMATION

USB_NODE_CONNECTION_INFORMATION_EX