WdfUsbTargetPipeGetIoTarget 함수(wdfusb.h)

  • 아티클

[KMDF 및 UMDF에 적용]

WdfUsbTargetPipeGetIoTarget 메서드는 지정된 USB 파이프와 연결된 I/O 대상 개체에 대한 핸들을 반환합니다.

구문

WDFIOTARGET WdfUsbTargetPipeGetIoTarget(
  [in] WDFUSBPIPE Pipe
);

매개 변수

[in] Pipe

WdfUsbInterfaceGetConfiguredPipe를 호출하여 가져온 프레임워크 파이프 개체에 대한 핸들입니다.

반환 값

WdfUsbTargetPipeGetIoTarget 은 지정된 파이프 개체와 연결된 I/O 대상 개체에 대한 핸들을 반환합니다.

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

설명

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

예제

다음 코드 예제에서는 EvtDeviceD0Entry 콜백 함수가 USB 파이프에 대한 연속 판독기를 시작하는 방법을 보여줍니다.

NTSTATUS
MyEvtDeviceD0Entry(
    IN  WDFDEVICE Device,
    IN  WDF_POWER_DEVICE_STATE PreviousState
)
{
    PDEVICE_CONTEXT  pDeviceContext;
    NTSTATUS  status;

    pDeviceContext = GetMyDeviceContext(Device);

    status = WdfIoTargetStart(WdfUsbTargetPipeGetIoTarget(pDeviceContext->InterruptPipe));

    return status;
}

요구 사항

요구 사항 값
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
최소 UMDF 버전 2.0
머리글 wdfusb.h(Wdfusb.h 포함)
라이브러리 Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF)
IRQL 모든 수준
DDI 규정 준수 규칙 DriverCreate(kmdf), FailD0EntryIoTargetState(kmdf)

추가 정보

WdfUsbInterfaceGetConfiguredPipe

WdfUsbTargetDeviceGetIoTarget