UcxUsbDeviceCreate 함수(ucxusbdevice.h)

지정된 컨트롤러에 USB 디바이스 개체를 만듭니다.

구문

NTSTATUS UcxUsbDeviceCreate(
  [in]           UCXCONTROLLER          Controller,
  [out]          PUCXUSBDEVICE_INIT     *UsbDeviceInit,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          UCXUSBDEVICE           *UsbDevice
);

매개 변수

[in] Controller

컨트롤러 개체에 대한 핸들입니다. 클라이언트 드라이버는 UcxControllerCreate에 대한 이전 호출에서 핸들을 검색했습니다.

[out] UsbDeviceInit

USB 디바이스 개체를 만들기 위한 다양한 구성 작업을 설명하는 UCXUSBDEVICE_INIT 구조체에 대한 포인터입니다. 드라이버는 이 구조체의 콜백 함수에 대한 함수 포인터를 지정합니다. 이 구조체는 UCX에서 관리됩니다.

[in, optional] Attributes

USB 디바이스 개체의 특성을 지정하는 호출자가 할당한 WDF_OBJECT_ATTRIBUTES 구조체에 대한 포인터입니다.

[out] UsbDevice

새 USB 디바이스 개체에 대한 핸들을 수신하는 변수에 대한 포인터입니다.

반환 값

메서드는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 메서드가 적절한 NTSTATUS 오류 코드 하나를 반환할 수 있습니다.

설명

호스트 컨트롤러의 클라이언트 드라이버는 WdfDeviceCreate 호출 후에 이 메서드를 호출해야 합니다. 새 USB 디바이스 개체의 부모는 UCX에서 지정한 부모 허브 디바이스입니다.

코드 예제는 EVT_UCX_CONTROLLER_USBDEVICE_ADD 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10
대상 플랫폼	Windows
최소 KMDF 버전	1.0
최소 UMDF 버전	2.0
머리글	ucxusbdevice.h(Ucxclass.h 포함)
IRQL	PASSIVE_LEVEL

추가 정보

EVT_UCX_CONTROLLER_USBDEVICE_ADD