UcxEndpointCreate 함수(ucxendpoint.h)

지정된 USB 디바이스 개체에 엔드포인트를 만듭니다.

구문

NTSTATUS UcxEndpointCreate(
  [in]           UCXUSBDEVICE           UsbDevice,
  [out]          PUCXENDPOINT_INIT      *EndpointInit,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          UCXENDPOINT            *Endpoint
);

매개 변수

[in] UsbDevice

엔드포인트를 포함하는 USB 디바이스 개체에 대한 핸들입니다. 클라이언트 드라이버는 UcxUsbDeviceCreate에 대한 이전 호출에서 핸들을 검색했습니다.

[out] EndpointInit

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

[in, optional] Attributes

엔드포인트 개체의 특성을 지정하는 호출자가 할당한 WDF_OBJECT_ATTRIBUTES 구조체에 대한 포인터입니다.

[out] Endpoint

새 엔드포인트 개체에 대한 핸들을 수신하는 변수에 대한 포인터입니다.

반환 값

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

설명

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

메서드는 엔드포인트 유형, 파이프, 전송 및 최대 전송 크기와 같은 정보를 사용하여 엔드포인트 개체를 초기화합니다.

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

요구 사항

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