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)를 대상으로 합니다.
주 코드
입력 버퍼
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