Funzione WdfUsbTargetDeviceWdmGetConfigurationHandle (wdfusb.h)
[Si applica solo a KMDF]
Il metodo WdfUsbTargetDeviceWdmGetConfigurationHandle restituisce l'handle tipizzato di USBD_CONFIGURATION_HANDLE associato alla configurazione corrente di un dispositivo USB specificato.
Sintassi
USBD_CONFIGURATION_HANDLE WdfUsbTargetDeviceWdmGetConfigurationHandle(
[in] WDFUSBDEVICE UsbDevice
);
Parametri
[in] UsbDevice
Handle per un oggetto dispositivo USB ottenuto da una chiamata precedente a WdfUsbTargetDeviceCreateWithParameters.
Valore restituito
Se il driver ha selezionato una configurazione per il dispositivo, WdfUsbTargetDeviceWdmGetConfigurationHandle restituisce l'handle tipizzato del dispositivo USBD_CONFIGURATION_HANDLE. In caso contrario, il metodo restituisce NULL.
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Commenti
Un driver basato su framework deve ottenere un handle tipizzato di USBD_CONFIGURATION_HANDLE solo se crea un'ottimizzazione che contiene una struttura _URB_SELECT_INTERFACE .
Il driver può chiamare WdfUsbTargetDeviceWdmGetConfigurationHandle dopo aver chiamato WdfUsbTargetDeviceSelectConfig. L'handle tipizzato di USBD_CONFIGURATION_HANDLE restituito da WdfUsbTargetDeviceWdmGetConfigurationHandle è valido fino a quando il driver chiama nuovamente WdfUsbTargetDeviceSelectConfig o l'oggetto dispositivo USB viene eliminato. Se il driver fornisce una funzione EvtCleanupCallback per l'oggetto dispositivo USB e se l'oggetto viene eliminato prima che il driver chiami nuovamente WdfUsbTargetDeviceSelectConfig , l'handle è valido fino a quando non viene restituita la funzione EvtCleanupCallback dell'oggetto.
Per altre informazioni sul metodo WdfUsbTargetDeviceWdmGetConfigurationHandle e sulle destinazioni di I/O USB, vedere Destinazioni di I/O USB.
Esempio
Nell'esempio di codice seguente viene ottenuto un handle per la configurazione corrente di un dispositivo USB specificato.
USBD_CONFIGURATION_HANDLE deviceConfigHdl;
deviceConfigHdl = WdfUsbTargetDeviceWdmGetConfigurationHandle(UsbDevice);
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Intestazione | wdfusb.h (include Wdfusb.h) |
| Libreria | Wdf01000.sys (vedere Controllo delle versioni della libreria framework). |
| IRQL | <=DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |