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