ucxusbdevice.h 헤더

이 헤더는 USB 호스트 컨트롤러 드라이버를 작성하는 데 사용됩니다. USB 호스트 컨트롤러 확장은 시스템 제공 드라이버(Ucx01000.sys)입니다. 이 드라이버는 Windows 드라이버 프레임워크 프로그래밍 인터페이스를 사용하여 프레임워크 클래스 확장으로 구현됩니다. 호스트 컨트롤러 드라이버는 해당 클래스 확장에 대한 클라이언트 드라이버 역할을 합니다. 호스트 컨트롤러 드라이버가 하드웨어 작업 및 이벤트, 전원 관리 및 PnP 이벤트를 처리하는 동안 UCX는 호스트 컨트롤러 드라이버에 대한 요청을 큐에 대기하고 다른 작업을 수행하는 추상화된 인터페이스 역할을 합니다.

이 헤더를 직접 포함하지 마세요. 대신 Ucxclass.h 포함

자세한 내용은 다음을 참조하세요.

• USB 호스트 컨트롤러용 Windows 드라이버 개발
• USB(범용 직렬 버스)

ucxusbdevice.h에는 다음과 같은 프로그래밍 인터페이스가 포함되어 있습니다.

함수

UCX_USBDEVICE_EVENT_CALLBACKS_INIT 클라이언트 드라이버의 콜백 함수에 대한 함수 포인터를 사용하여 UCX_USBDEVICE_EVENT_CALLBACKS 구조를 초기화합니다.
UcxUsbDeviceCreate 지정된 컨트롤러에 USB 디바이스 개체를 만듭니다.
UcxUsbDeviceInitSetEventCallbacks 클라이언트 드라이버의 이벤트 콜백 함수를 사용하여 UCXUSBDEVICE_INIT 구조를 초기화합니다.
UcxUsbDeviceRemoteWakeNotification 디바이스에서 원격 절전 모드 해제 신호가 수신되었음을 UCX에 알릴 수 있습니다.

콜백 함수

EVT_UCX_USBDEVICE_ADDRESS UCX가 USB 디바이스를 해결하기 위해 호출하는 클라이언트 드라이버의 구현입니다.
EVT_UCX_USBDEVICE_DEFAULT_ENDPOINT_ADD UCX가 USB 디바이스에 대한 새 기본 엔드포인트를 추가하기 위해 호출하는 클라이언트 드라이버의 구현입니다.
EVT_UCX_USBDEVICE_DISABLE UCX가 디바이스 및 기본 엔드포인트와 연결된 컨트롤러 리소스를 릴리스하기 위해 호출하는 클라이언트 드라이버의 구현입니다.
EVT_UCX_USBDEVICE_ENABLE UCX가 디바이스 및 기본 제어 엔드포인트에 대한 프로그램 정보를 컨트롤러에 호출하는 클라이언트 드라이버의 구현입니다.
EVT_UCX_USBDEVICE_ENDPOINT_ADD UCX가 USB 디바이스에 대한 새 엔드포인트를 추가하기 위해 호출하는 클라이언트 드라이버의 구현입니다.
EVT_UCX_USBDEVICE_ENDPOINTS_CONFIGURE UCX가 컨트롤러에서 엔드포인트를 구성하기 위해 호출하는 클라이언트 드라이버의 구현입니다.
EVT_UCX_USBDEVICE_GET_CHARACTERISTIC UCX는 이 콜백을 호출하여 디바이스 특성을 검색합니다.
EVT_UCX_USBDEVICE_HUB_INFO UCX가 허브 속성을 검색하기 위해 호출하는 클라이언트 드라이버의 구현입니다.
EVT_UCX_USBDEVICE_RESET 디바이스가 연결된 포트가 다시 설정되면 UCX에서 호출하는 클라이언트 드라이버의 구현입니다.
EVT_UCX_USBDEVICE_RESUME UCX는 이 콜백 함수를 호출하여 디바이스를 일시 중단 상태에서 다시 시작합니다.
EVT_UCX_USBDEVICE_SUSPEND UCX는 이 콜백 함수를 호출하여 디바이스 일시 중단 상태를 보냅니다.
EVT_UCX_USBDEVICE_UPDATE UCX가 디바이스 속성을 업데이트하기 위해 호출하는 클라이언트 드라이버의 구현입니다.

구조체

ADDRESS0_OWNERSHIP_ACQUIRE 디바이스를 구성하기 위한 매개 변수를 포함합니다.
UCX_USBDEVICE_CHARACTERISTIC 디바이스의 특성을 저장합니다.
UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY 등시 전송 경로 지연 값을 저장하는 방법을 알아봅니다.
UCX_USBDEVICE_EVENT_CALLBACKS 이 구조는 UCX USB 디바이스 이벤트 콜백 함수 목록을 제공합니다.
UCXUSBDEVICE_INFO USB 디바이스에 대한 정보를 포함합니다. 이 구조는 EVT_UCX_CONTROLLER_USBDEVICE_ADD 이벤트 콜백 함수에서 UCX에 의해 전달됩니다.
USB_DEVICE_PORT_PATH USB 디바이스의 포트 경로를 포함합니다.
USBDEVICE_ABORTIO 데이터 전송을 중단할 USB(유니버설 직렬 버스) 허브 또는 디바이스에 대한 핸들을 포함합니다.
USBDEVICE_ADDRESS 지정된 디바이스를 Addressed 상태로 전환하기 위한 요청에 대한 매개 변수를 포함합니다. 이 구조는 EVT_UCX_USBDEVICE_ADDRESS 콜백 함수의 프레임워크 요청 개체의 요청 매개 변수(Parameters.Others.Arg1)에서 UCX에 의해 전달됩니다.
USBDEVICE_DISABLE 지정된 디바이스를 사용하지 않도록 설정하는 요청에 대한 매개 변수를 포함합니다. 이 구조는 EVT_UCX_USBDEVICE_DISABLE 콜백 함수의 프레임워크 요청 개체의 요청 매개 변수(Parameters.Others.Arg1)에서 UCX에 의해 전달됩니다.
USBDEVICE_ENABLE 지정된 디바이스를 사용하도록 설정하는 요청에 대한 매개 변수를 포함합니다. 이 구조는 EVT_UCX_USBDEVICE_ENABLE 콜백 함수의 프레임워크 요청 개체의 요청 매개 변수(Parameters.Others.Arg1)에서 UCX에 의해 전달됩니다.
USBDEVICE_ENABLE_FAILURE_FLAGS EVT_UCX_USBDEVICE_ENABLE 콜백 함수에서 클라이언트 드라이버가 설정하는 플래그입니다. 디바이스를 사용하도록 설정하는 동안 발생했을 수 있는 오류가 있는 경우 를 나타냅니다.
USBDEVICE_HUB_INFO 지정된 허브에 대한 정보를 가져오기 위한 요청에 대한 매개 변수를 포함합니다. 이 구조는 EVT_UCX_USBDEVICE_HUB_INFO 콜백 함수의 프레임워크 요청 개체의 요청 매개 변수(Parameters.Others.Arg1)에서 UCX에 의해 전달됩니다.
USBDEVICE_MGMT_HEADER 이 구조체는 USB(유니버설 직렬 버스) 허브 또는 버스에 물리적으로 연결된 디바이스에 대한 핸들을 제공합니다.
USBDEVICE_PURGEIO USBDEVICE_PURGEIO 구조에는 I/O를 제거할 USB(유니버설 직렬 버스) 허브 또는 디바이스에 대한 핸들이 포함되어 있습니다.
USBDEVICE_RESET 지정된 디바이스를 다시 설정하는 요청에 대한 매개 변수를 포함합니다. 이 구조는 EVT_UCX_USBDEVICE_RESET 콜백 함수의 프레임워크 요청 개체의 요청 매개 변수(Parameters.Others.Arg1)에서 UCX에 의해 전달됩니다.
USBDEVICE_STARTIO 데이터 전송을 시작할 USB(유니버설 직렬 버스) 허브 또는 디바이스에 대한 핸들을 포함합니다.
USBDEVICE_TREE_PURGEIO 이 구조체는 I/O를 제거하는 USB(유니버설 직렬 버스) 디바이스 트리에 대한 핸들을 제공합니다.
USBDEVICE_UPDATE UCX에서 지정된 디바이스를 업데이트하기 위해 전달됩니다. 이 구조는 EVT_UCX_USBDEVICE_UPDATE 콜백 함수에 전달된 프레임워크 요청 개체의 요청 매개 변수(Parameters.Others.Arg1)에 있습니다.
USBDEVICE_UPDATE_20_HARDWARE_LPM_PARAMETERS USB 2.0 LPM(링크 전원 관리)을 업데이트하는 요청에 대한 매개 변수를 포함합니다. UCX는 EVT_UCX_USBDEVICE_UPDATE 콜백 함수에서 이 구조를 전달합니다.
USBDEVICE_UPDATE_FAILURE_FLAGS EVT_UCX_USBDEVICE_UPDATE 콜백 함수에서 클라이언트 드라이버가 설정하는 플래그입니다. 디바이스를 업데이트하는 동안 발생했을 수 있는 오류가 있는 경우 표시합니다.
USBDEVICE_UPDATE_FLAGS UCX가 클라이언트 드라이버의 EVT_UCX_USBDEVICE_UPDATE 콜백 함수를 호출할 때 USBDEVICE_UPDATE 구조에 전달되는 UCX에서 설정한 요청 플래그를 포함합니다.

열거형

UCX_USBDEVICE_CHARACTERISTIC_TYPE 디바이스 특성의 유형을 나타내는 값을 정의합니다.
UCX_USBDEVICE_RECOVERY_ACTION FLDR 및 PLDR 트리거 재설정에 대한 값을 정의합니다.