EVT_UFX_DEVICE_TEST_MODE_SET función de devolución de llamada (ufxclient.h)
La implementación del controlador cliente para establecer el modo de prueba del controlador de función.
Sintaxis
EVT_UFX_DEVICE_TEST_MODE_SET EvtUfxDeviceTestModeSet;
void EvtUfxDeviceTestModeSet(
[in] UFXDEVICE unnamedParam1,
[in] ULONG unnamedParam2
)
{...}
Parámetros
[in] unnamedParam1
Identificador de un objeto de dispositivo USB que el controlador cliente recibió en una llamada anterior a UfxDeviceCreate.
[in] unnamedParam2
Valor del selector del modo de prueba tal y como se define en la especificación USB 2.0. Estos valores se definen en usbfnbase.h.
- USB_TEST_MODE_TEST_J 0x01
- USB_TEST_MODE_TEST_K 0x02
- USB_TEST_MODE_TEST_SE0_NAK 0x03
- USB_TEST_MODE_TEST_PACKET 0x04
- USB_TEST_MODE_TEST_FORCE_ENABLE 0x05
Valor devuelto
None
Observaciones
El controlador cliente para el controlador host de función registra su implementación de EVT_UFX_DEVICE_TEST_MODE_SET con la extensión de clase de función USB (UFX) llamando al método UfxDeviceCreate .
El controlador cliente indica la finalización de este evento llamando al método UfxDeviceEventComplete .
Ejemplos
EVT_UFX_DEVICE_TEST_MODE_SET UfxDevice_EvtDeviceTestModeSet;
VOID
UfxDevice_EvtDeviceTestModeSet (
_In_ UFXDEVICE UfxDevice,
_In_ ULONG TestMode
)
/*++
Routine Description:
EvtDeviceTestModeSet handler for the UFXDEVICE object.
Handles a set test mode request from the host. Places the controller into
the specified test mode.
Arguments:
UfxDevice - UFXDEVICE object representing the device.
TestMode - Test mode value. See Section 7.1.20 of the USB 2.0 specification for definitions of
each test mode.
--*/
{
NTSTATUS Status;
UNREFERENCED_PARAMETER(TestMode);
TraceEntry();
//
// #### TODO: Insert code to put the controller into the specified test mode ####
//
Status = STATUS_SUCCESS;
UfxDeviceEventComplete(UfxDevice, Status);
TraceExit();
}
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Versión mínima de KMDF | 1.0 |
| Versión mínima de UMDF | 2.0 |
| Encabezado | ufxclient.h |
| IRQL | <=DISPATCH_LEVEL |