Funzione WdfUsbInterfaceGetNumEndpoints (wdfusb.h)

  • Articolo

[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)

Vedi anche

WdfUsbTargetDeviceGetInterface