EVT_UDECX_USB_DEVICE_SET_FUNCTION_SUSPEND_AND_WAKE 콜백 함수(udecxusbdevice.h)
USB 디바이스 에뮬레이션 클래스 확장(UdeCx)은 가상 USB 3.0 디바이스의 지정된 인터페이스의 함수 상태를 변경하라는 요청을 받으면 이 콜백 함수를 호출합니다.
구문
EVT_UDECX_USB_DEVICE_SET_FUNCTION_SUSPEND_AND_WAKE EvtUdecxUsbDeviceSetFunctionSuspendAndWake;
NTSTATUS EvtUdecxUsbDeviceSetFunctionSuspendAndWake(
[in] WDFDEVICE UdecxWdfDevice,
[in] UDECXUSBDEVICE UdecxUsbDevice,
[in] ULONG Interface,
[in] UDECX_USB_DEVICE_FUNCTION_POWER FunctionPower
)
{...}
매개 변수
[in] UdecxWdfDevice
USB 디바이스가 연결된 컨트롤러를 나타내는 프레임워크 디바이스 개체에 대한 핸들입니다. 클라이언트 드라이버는 UdecxWdfDeviceAddUsbDeviceEmulation에 대한 이전 호출에서 이 개체를 초기화했습니다.
[in] UdecxUsbDevice
UDE 디바이스 개체에 대한 핸들입니다. 클라이언트 드라이버는 UdecxUsbDeviceCreate에 대한 이전 호출에서 이 개체를 만들었습니다.
[in] Interface
이 값은 절전 모드에서 해제되는 인터페이스의 bInterfaceNumber 입니다.
[in] FunctionPower
인터페이스가 호스트 컨트롤러에 절전 모드 해제 신호를 일시 중단하고 보낼 수 있는지 여부를 나타내는 UDECX_USB_DEVICE_FUNCTION_POWER 형식 값입니다.
반환 값
작업이 성공하면 콜백 함수는 STATUS_SUCCESS 반환하거나 NT_SUCCESS(상태)이 TRUE인 다른 상태 값을 반환해야 합니다.
설명
클라이언트 드라이버는 구현에 대한 함수 포인터를 제공하여 UdecxUsbDeviceInitSetStateChangeCallbacks 에 대한 이전 호출에서 함수를 등록했습니다.
콜백 구현에서 USB 디바이스의 클라이언트 드라이버는 작업 상태를 입력하는 단계를 수행해야 합니다.
이 이벤트 콜백 함수는 USB 3.0 이상 디바이스에 적용됩니다. UdeCx는 이 함수를 호출하여 클라이언트 드라이버에 특정 함수의 전원 상태를 변경하라는 요청을 알립니다. 또한 함수가 새 상태에서 절전 모드를 해제할 수 있는지 여부를 드라이버에 알릴 수 있습니다.
전원 요청은 STATUS_PENDING 반환한 다음 나중에 실제 완료 코드로 UdecxUsbDeviceSetFunctionSuspendAndWakeComplete 를 호출하여 완료하여 비동기적으로 완료될 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 |
| 지원되는 최소 서버 | Windows Server 2016 |
| 대상 플랫폼 | Windows |
| 최소 KMDF 버전 | 1.15 |
| 머리글 | udecxusbdevice.h(Udecx.h 포함) |
| IRQL | <=DISPATCH_LEVEL |