USB_NODE_CONNECTION_INFORMATION 구조체(usbioctl.h)

아티클
02/29/2024

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 열거자의 값을 지정할 수 있습니다.