WdfUsbTargetPipeWdmGetPipeHandle 함수(wdfusb.h)
[KMDF에만 적용]
WdfUsbTargetPipeWdmGetPipeHandle 메서드는 지정된 프레임워크 파이프 개체와 연결된 USBD_PIPE_HANDLE 형식의 핸들을 반환합니다.
통사론
USBD_PIPE_HANDLE WdfUsbTargetPipeWdmGetPipeHandle(
[in] WDFUSBPIPE UsbPipe
);
매개 변수
[in] UsbPipe
WdfUsbInterfaceGetConfiguredPipe호출하여 가져온 프레임워크 파이프 개체에 대한 핸들입니다.
반환 값
WdfUsbTargetPipeWdmGetPipeHandle USBD_PIPE_HANDLE 형식의 핸들을 반환합니다.
드라이버에서 잘못된 개체 핸들을 제공하면 버그 검사가 수행됩니다.
발언
프레임워크 기반 드라이버는 파이프 핸들이 필요한 URB 만드는 경우에만 USBD_PIPE_HANDLE 형식의 핸들을 가져와야 합니다.
드라이버는 WdfUsbTargetDeviceSelectConfig호출한 후 WdfUsbTargetPipeWdmGetPipeHandle 메서드를 호출할 수 있습니다. WdfUsbTargetPipeWdmGetPipeHandle 반환하는 USBD_PIPE_HANDLE 형식의 핸들은 드라이버가 WdfUsbTargetDeviceSelectConfig 호출하거나 드라이버가 WdfUsbInterfaceSelectSetting 호출하거나 프레임워크 파이프 개체가 삭제될 때까지 유효합니다. 드라이버가 프레임워크 파이프 개체에 대한 EvtCleanupCallback 함수를 제공하는 경우 드라이버가 WdfUsbTargetDeviceSelectConfig 호출하거나 WdfUsbInterfaceSelectSetting 호출하기 전에 개체가 삭제되면 개체의 EvtCleanupCallback 함수가 반환될 때까지 핸들이 유효합니다.
WdfUsbTargetPipeWdmGetPipeHandle 메서드 및 USB I/O 대상에 대한 자세한 내용은 USB I/O 대상참조하세요.
예제
다음 코드 예제에서는 지정된 파이프에 대한 USBD_PIPE_HANDLE 형식 핸들을 가져옵니다.
USBD_PIPE_HANDLE usbdPipeHandle;
usbdPipeHandle = WdfUsbTargetPipeWdmGetPipeHandle(UsbPipe);
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 최소 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) |