Metodo IWDFUsbTargetDevice::RetrieveUsbInterface (wudfusb.h)
[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre info, vedi Introduzione con UMDF.]
Il metodo RetrieveUsbInterface recupera l'interfaccia USB specificata per un dispositivo USB.
Sintassi
HRESULT RetrieveUsbInterface(
[in] UCHAR InterfaceIndex,
[out] IWDFUsbInterface **ppUsbInterface
);
Parametri
[in] InterfaceIndex
Indice dell'interfaccia da recuperare.
[out] ppUsbInterface
Puntatore a una variabile che riceve un puntatore all'interfaccia IWDFUsbInterface specificata per il dispositivo USB.
Valore restituito
RetrieveUsbInterface restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
|
RetrieveUsbInterface ha recuperato correttamente l'interfaccia USB specificata per il dispositivo USB. |
|
RetrieveUsbInterface ha rilevato un errore di allocazione. |
|
Questo valore corrisponde al codice di errore restituito dall'API WinUsb. |
Commenti
Il driver può chiamare il metodo IWDFUsbTargetDevice::GetNumInterfaces per recuperare il numero totale di interfacce USB disponibili.
Il driver può usare il puntatore di interfaccia recuperato da RetrieveUsbInterface , per chiamare i metodi forniti dall'interfaccia IWDFUsbInterface . Per altre informazioni sull'uso di questi metodi, vedere Uso delle interfacce USB in UMDF.
Esempio
Per un esempio di codice su come usare il metodo RetrieveUsbInterface , vedere IWDFUsbTargetFactory::CreateUsbTargetDevice.
Requisiti
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| Piattaforma di destinazione | Desktop |
| Versione UMDF minima | 1.5 |
| Intestazione | wudfusb.h (include Wudfusb.h) |
| DLL | WUDFx.dll |