Funzione WdfUsbInterfaceGetNumEndpoints (wdfusb.h)
[Si applica a KMDF e UMDF]
Il metodo WdfUsbInterfaceGetNumEndpoints restituisce il numero di endpoint associati a un'impostazione alternativa specificata di un'interfaccia USB specificata.
Sintassi
BYTE WdfUsbInterfaceGetNumEndpoints(
[in] WDFUSBINTERFACE UsbInterface,
[in] UCHAR SettingIndex
);
Parametri
[in] UsbInterface
Handle a un oggetto interfaccia USB ottenuto chiamando WdfUsbTargetDeviceGetInterface.
[in] SettingIndex
Valore di indice che identifica un'impostazione alternativa per l'interfaccia. Per altre informazioni sulle impostazioni alternative, vedere la specifica USB.
Valore restituito
Se l'indice specificato è valido, WdfUsbInterfaceGetNumEndpoints restituisce il numero di endpoint associati all'impostazione alternativa dell'interfaccia specificata. In caso contrario, il metodo restituisce zero.
Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.
Commenti
Per altre informazioni sul metodo WdfUsbInterfaceGetNumEndpoints e sulle destinazioni di I/O USB, vedere Destinazioni di I/O USB.
Esempio
Nell'esempio di codice seguente viene ottenuto il numero di endpoint per l'impostazione alternativa 0 di un'interfaccia USB specificata.
BYTE numEndpoints;
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
UsbInterface,
0
);
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Versione UMDF minima | 2,0 |
| Intestazione | wdfusb.h (include Wdfusb.h) |
| Libreria | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |