EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER 콜백 함수(ucxcontroller.h)

UCX가 현재 32비트 프레임 번호를 검색하기 위해 호출하는 클라이언트 드라이버의 구현입니다.

구문

EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER EvtUcxControllerGetCurrentFramenumber;

NTSTATUS EvtUcxControllerGetCurrentFramenumber(
  [in]  UCXCONTROLLER UcxController,
  [out] PULONG FrameNumber
)
{...}

매개 변수

[in] UcxController

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

[out] FrameNumber

현재 32비트 프레임 번호에 대한 포인터입니다.

반환 값

작업이 성공하면 콜백 함수는 STATUS_SUCCESS 반환하거나 NT_SUCCESS(상태)이 TRUE인 다른 상태 값을 반환해야 합니다. 그렇지 않으면 NT_SUCCESS(상태)가 FALSE와 같은 상태 값을 반환해야 합니다.

설명

UCX 클라이언트 드라이버는 UcxControllerCreate 메서드를 호출하여 EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER 구현을 UCX(USB 호스트 컨트롤러 확장)에 등록합니다.

예제

NTSTATUS
Controller_EvtControllerGetCurrentFrameNumber(
    UCXCONTROLLER   UcxController,
    PULONG          FrameNumber
)

{
    UNREFERENCED_PARAMETER(UcxController);

    //
    // TODO: Return the current 32-bit frame number.  Do not access the
    // controller registers if the controller is not in D0.
    //

    *FrameNumber = 0xFFFFFFFF;

    DbgTrace(TL_INFO, Controller, "Controller_EvtControllerGetCurrentFrameNumber");

    return STATUS_SUCCESS;
}

요구 사항

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

추가 정보

UcxControllerCreate