EVT_UFX_DEVICE_TEST_MODE_SET Rückruffunktion (ufxclient.h)
Die Implementierung des Clienttreibers zum Festlegen des Testmodus des Funktionscontrollers.
Syntax
EVT_UFX_DEVICE_TEST_MODE_SET EvtUfxDeviceTestModeSet;
void EvtUfxDeviceTestModeSet(
[in] UFXDEVICE unnamedParam1,
[in] ULONG unnamedParam2
)
{...}
Parameter
[in] unnamedParam1
Das Handle für ein USB-Geräteobjekt, das der Clienttreiber in einem vorherigen Aufruf des UfxDeviceCreateempfangen hat.
[in] unnamedParam2
Testmodusauswahlwert gemäß definition der USB 2.0-Spezifikation. Diese Werte werden in usbfnbase.h definiert.
- 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
Rückgabewert
Nichts
Bemerkungen
Der Clienttreiber für den Funktionshostcontroller registriert seine EVT_UFX_DEVICE_TEST_MODE_SET Implementierung mit der USB-Funktionsklassenerweiterung (UFX), indem die UfxDeviceCreate-Methode aufgerufen wird.
Der Clienttreiber gibt den Abschluss dieses Ereignisses an, indem die UfxDeviceEventComplete--Methode aufgerufen wird.
Beispiele
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();
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Header- | ufxclient.h |
| IRQL- | <=DISPATCH_LEVEL |