IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES IOCTL(usbioctl.h)

IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES I/O 제어 요청은 특정 포트에 대한 Microsoft 확장 포트 특성을 검색합니다.

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

주 코드

IRP_MJ_DEVICE_CONTROL

입력 버퍼

ASSOCIATedIrp.SystemBuffer 멤버는 사용자가 할당한 USB_NODE_CONNECTION_ATTRIBUTES 구조를 가리킵니다. 입력에서 호출자는 USB_NODE_CONNECTION_ATTRIBUTES 구조체의 ConnectionIndex 멤버에 포트 번호를 지정합니다.

입력 버퍼 길이

USB_NODE_CONNECTION_ATTRIBUTES 구조체의 크기입니다.

출력 버퍼

출력 시 AssociatedIrp.SystemBuffer의 USB_NODE_CONNECTION_ATTRIBUTES 구조체는 포트에 대한 Microsoft 확장 포트 특성을 설명합니다. 참고 Windows Vista, Windows Server 2008 및 Windows 7의 경우 Microsoft 확장 포트 특성 필드는 0으로 설정됩니다.

Windows XP 및 Windows Server 2003의 경우 Microsoft 확장 포트 특성이 USB_PORTATTR_NO_OVERCURRENT_UI 설정될 수 있습니다. 이 값은 포트에서 과류가 발생할 때 사용자 인터페이스가 숨겨지게 됨을 나타냅니다.

출력 버퍼 길이

Parameters.DeviceIoControl.OutputBufferLength 는 SystemBuffer에서 반환된 데이터의 크기(바이트)를 나타냅니다.

상태 블록

USB 스택은 요청이 성공하면 Irp-IoStatus.Status>를 STATUS_SUCCESS 설정합니다. 그렇지 않으면 USB 스택은 상태를 STATUS_INVALID_PARAMETER 또는 STATUS_INSUFFICIENT_RESOURCES 같은 적절한 오류 조건으로 설정합니다. 허브가 시작되지 않았거나 작동하지 않는 경우 요청은 STATUS_UNSUCCESSFUL 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP, Windows Server 2003 이상.
머리글	usbioctl.h(Usbioctl.h 포함)

추가 정보

USB_NODE_CONNECTION_ATTRIBUTES