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 informazioni, vedi Introduzione a 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 al IWDFUsbInterface specificato'interfaccia per il dispositivo USB.
Valore restituito
RetrieveUsbInterface restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
|
RetrieveUsbInterface recuperato correttamente l'interfaccia USB specificata per il dispositivo USB. |
|
RetrieveUsbInterface rilevato un errore di allocazione. |
|
Questo valore corrisponde al codice di errore restituito dall'API WinUsb. |
Osservazioni
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 che RetrieveUsbInterface recupera, per chiamare i metodi forniti dall'interfaccia IWDFUsbInterface. Per altre informazioni sull'uso di questi metodi, vedere Uso delle interfacce USB in UMDF.
Esempi
Per un esempio di codice su come usare il metodo RetrieveUsbInterface, vedere IWDFUsbTargetFactory::CreateUsbTargetDevice.
Fabbisogno
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| piattaforma di destinazione | Desktop |
| versione minima di UMDF | 1.5 |
| intestazione | wudfusb.h (include Wudfusb.h) |
| dll | WUDFx.dll |