EVT_UCX_USBDEVICE_ENDPOINTS_CONFIGURE 콜백 함수(ucxusbdevice.h)

UCX가 컨트롤러에서 엔드포인트를 구성하기 위해 호출하는 클라이언트 드라이버의 구현입니다.

구문

EVT_UCX_USBDEVICE_ENDPOINTS_CONFIGURE EvtUcxUsbdeviceEndpointsConfigure;

void EvtUcxUsbdeviceEndpointsConfigure(
  [in] UCXCONTROLLER UcxController,
  [in] WDFREQUEST Request
)
{...}

매개 변수

[in] UcxController

UcxControllerCreate 메서드에 대한 이전 호출에서 클라이언트 드라이버가 받은 UCX 컨트롤러에 대한 핸들입니다.

[in] Request

형식 ENDPOINTS_CONFIGURE 구조체의 구조를 포함합니다.

반환 값

없음

설명

UCX 클라이언트 드라이버는 UcxUsbDeviceCreate 메서드를 호출하여 이 콜백 함수를 UCX(USB 호스트 컨트롤러 확장)에 등록합니다.

콜백에서 드라이버는 ENDPOINTS_CONFIGURE 구조에 설명된 대로 엔드포인트를 프로그래밍하거나 프로그래밍 해제합니다.

이 콜백은 기본 엔드포인트를 사용하거나 사용하지 않도록 설정하지 않습니다. 기본 엔드포인트의 상태는 디바이스의 상태에 연결됩니다. 드라이버는 EVT_UCX_USBDEVICE_DISABLE 및 EVT_UCX_USBDEVICE_ENABLE콜백 함수에서 사용 및 사용 안 함 작업을 구현합니다.

클라이언트 드라이버는 요청에서 완료 상태 반환합니다. 드라이버는 WDFREQUEST를 비동기적으로 완료할 수 있습니다.

예제

VOID
UsbDevice_EvtUcxUsbDeviceEndpointsConfigure(
    UCXCONTROLLER      UcxController,
    WDFREQUEST         Request
)

{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceEndpointsConfigure");

    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(WdfRequest, &wdfRequestParams);

    ...

    endpointsConfigure = (PENDPOINTS_CONFIGURE)wdfRequestParams.Parameters.Others.Arg1;

    ...

    WdfRequestComplete(Request, STATUS_SUCCESS);
}

요구 사항

요구 사항	값
대상 플랫폼	Windows
최소 KMDF 버전	1.0
최소 UMDF 버전	2.0
머리글	ucxusbdevice.h(Ucxclass.h 포함)
IRQL	DISPATCH_LEVEL

추가 정보

ENDPOINTS_CONFIGURE

UcxUsbDeviceCreate