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)

Vedi anche

URB

WdfUsbTargetDeviceSelectConfig

_URB_SELECT_INTERFACE