USB_NODE_CONNECTION_INFORMATION 구조체(usbioctl.h)

아티클
02/07/2025

USB_NODE_CONNECTION_INFORMATION 구조는 usb 포트 및 연결된 디바이스에 대한 정보를 검색하기 위해 IOCTL_USB_GET_NODE_CONNECTION_INFORMATION 요청과 함께 사용됩니다.

통사론

typedef struct _USB_NODE_CONNECTION_INFORMATION {
  ULONG                 ConnectionIndex;
  USB_DEVICE_DESCRIPTOR DeviceDescriptor;
  UCHAR                 CurrentConfigurationValue;
  BOOLEAN               LowSpeed;
  BOOLEAN               DeviceIsHub;
  USHORT                DeviceAddress;
  ULONG                 NumberOfOpenPipes;
  USB_CONNECTION_STATUS ConnectionStatus;
  USB_PIPE_INFO         PipeList[0];
} USB_NODE_CONNECTION_INFORMATION, *PUSB_NODE_CONNECTION_INFORMATION;

회원

ConnectionIndex

포트 수를 지정하는 1보다 크거나 같은 값입니다.

DeviceDescriptor

열거 중에 연결된 디바이스에서 반환하는 USB 디바이스 설명자를 보고하는 USB_DEVICE_DESCRIPTOR 구조체입니다.

CurrentConfigurationValue

지정된 포트에 연결된 디바이스의 현재 구성을 지정하기 위해 SetConfiguration 요청과 함께 사용되는 ID를 포함합니다. 이 값에 대한 설명은 USB 문서 라이브러리제공되는 유니버설 직렬 버스 3.1 사양의 섹션 9.4.7을 참조하세요.

LowSpeed

포트와 연결된 디바이스가 저속으로 작동하고 있는지 여부를 나타내는 부울 값입니다. TRUE 포트와 연결된 디바이스가 현재 저속으로 작동하고 있음을 나타냅니다. FALSE 그렇지 않으면 나타냅니다.

DeviceIsHub

포트에 연결된 디바이스가 허브인지 여부를 나타내는 부울 값입니다. TRUE 경우 포트에 연결된 디바이스는 허브입니다. FALSE 경우 디바이스는 허브가 아닙니다.

DeviceAddress

포트에 연결된 디바이스의 USB 할당 버스 상대 주소입니다.

NumberOfOpenPipes

포트와 연결된 열린 USB 파이프의 수입니다.

ConnectionStatus

연결 상태를 나타내는 USB_CONNECTION_STATUS형식의 열거자입니다.

PipeList[0]

포트와 연결된 열린 파이프를 설명하는 USB_PIPE_INFO 구조체의 배열입니다. 파이프 설명에는 파이프의 일정 오프셋과 연결된 엔드포인트 설명자가 포함됩니다. 이 정보는 대역폭 사용량을 계산하는 데 사용할 수 있습니다.

발언

USB 포트에 연결된 디바이스가 없는 경우 IOCTL_USB_GET_NODE_CONNECTION_INFORMATION 포트에 대한 정보만 반환합니다. 디바이스가 포트에 연결된 경우 IOCTL_USB_GET_NODE_CONNECTION_INFORMATION 포트와 연결된 디바이스에 대한 정보를 반환합니다.

USB_NODE_CONNECTION_INFORMATION_EX 구조는 확장 버전의 USB_NODE_CONNECTION_INFORMATION. 두 구조체는 하나의 멤버를 제외하고 동일합니다. USB_NODE_CONNECTION_INFORMATION_EXLowSpeed 멤버가 Speed 멤버로 대체됩니다. LowSpeed 부울 값이므로 TRUE 디바이스는 속도가 낮습니다. FALSE 디바이스는 고속 또는 전체 속도입니다. 따라서 USB_NODE_CONNECTION_INFORMATION 구조는 고속과 전체 속도를 구분할 수 없습니다.

USB_NODE_CONNECTION_INFORMATION_EX 구조체의 Speed 멤버는 UCHAR이며 USB_DEVICE_SPEED 열거자의 값을 지정할 수 있습니다.