EVT_UFX_DEVICE_TEST_MODE_SET funzione di callback (ufxclient.h)
Implementazione del driver client per impostare la modalità di test del controller di funzione.
Sintassi
EVT_UFX_DEVICE_TEST_MODE_SET EvtUfxDeviceTestModeSet;
void EvtUfxDeviceTestModeSet(
[in] UFXDEVICE unnamedParam1,
[in] ULONG unnamedParam2
)
{...}
Parametri
[in] unnamedParam1
Handle a un oggetto dispositivo USB ricevuto dal driver client in una chiamata precedente a UfxDeviceCreate.
[in] unnamedParam2
Valore del selettore della modalità di test definito dalla specifica USB 2.0. Questi valori sono definiti in 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
Valore restituito
nessuno
Osservazioni
Il driver client per il controller host della funzione registra la relativa implementazione EVT_UFX_DEVICE_TEST_MODE_SET con l'estensione della classe di funzione USB (UFX) chiamando il metodo UfxDeviceCreate .
Il driver client indica il completamento di questo evento chiamando il metodo UfxDeviceEventComplete .
Esempio
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();
}
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Versione KMDF minima | 1,0 |
| Versione UMDF minima | 2,0 |
| Intestazione | ufxclient.h |
| IRQL | <=DISPATCH_LEVEL |