WdfUsbTargetDeviceRetrieveCurrentFrameNumber 함수(wdfusb.h)

  • 아티클

[KMDF에만 적용]

WdfUsbTargetDeviceRetrieveCurrentFrameNumber 메서드는 현재 USB 프레임 번호를 검색합니다.

구문

NTSTATUS WdfUsbTargetDeviceRetrieveCurrentFrameNumber(
  [in]  WDFUSBDEVICE UsbDevice,
  [out] PULONG       CurrentFrameNumber
);

매개 변수

[in] UsbDevice

WdfUsbTargetDeviceCreateWithParameters에 대한 이전 호출에서 가져온 USB 디바이스 개체에 대한 핸들입니다.

[out] CurrentFrameNumber

현재 32비트 USB 프레임 번호를 받는 위치에 대한 포인터입니다.

반환 값

WdfUsbTargetDeviceRetrieveCurrentFrameNumber 는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 메서드는 다음 값 중 하나를 반환할 수 있습니다.

반환 코드 설명
STATUS_INVALID_PARAMETER
 잘못된 매개 변수가 감지되었습니다.
STATUS_UNSUCCESSFUL
 낮은 드라이버가 프레임 번호를 제공하지 않기 때문에 프레임 번호를 사용할 수 없습니다.
 

이 메서드는 다른 NTSTATUS 값을 반환할 수도 있습니다.

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

설명

WdfUsbTargetDeviceRetrieveCurrentFrameNumber 메서드 및 USB I/O 대상에 대한 자세한 내용은 USB I/O 대상을 참조하세요.

예제

다음 코드 예제 에서는 WdfUsbTargetDeviceRetrieveCurrentFrameNumber를 호출합니다. 이 예제에서는 드라이버 정의 컨텍스트 공간에서 USB 디바이스 개체 핸들을 가져옵니다.

ULONG  frameNumber;
PMY_DEVICE_CONTEXT  pMyDeviceContext;

pMyDeviceContext = GetDeviceContext(Device);

status = WdfUsbTargetDeviceRetrieveCurrentFrameNumber(
                                              pMyDeviceContext->UsbTargetDevice,
                                              &frameNumber
                                              );

요구 사항

요구 사항 값
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
머리글 wdfusb.h(Wdfusb.h 포함)
라이브러리 Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL <=DISPATCH_LEVEL
DDI 규정 준수 규칙 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

추가 정보

WdfUsbTargetDeviceCreateWithParameters