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