다음을 통해 공유


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