Funzione WdfUsbInterfaceGetEndpointInformation (wdfusb.h)
[Si applica a KMDF e UMDF]
Il metodo WdfUsbInterfaceGetEndpointInformation recupera informazioni su un endpoint dispositivo USB specificato e sulla relativa pipe associata.
Sintassi
void WdfUsbInterfaceGetEndpointInformation(
[in] WDFUSBINTERFACE UsbInterface,
[in] UCHAR SettingIndex,
[in] UCHAR EndpointIndex,
[in, out] PWDF_USB_PIPE_INFORMATION EndpointInfo
);
Parametri
[in] UsbInterface
Handle per 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, vedi la specifica USB.
[in] EndpointIndex
Valore di indice che identifica un endpoint associato all'impostazione alternativa specificata dell'interfaccia specificata. Questo valore di indice non è l'indirizzo dell'endpoint.
[in, out] EndpointInfo
Puntatore a una struttura WDF_USB_PIPE_INFORMATION allocata dal chiamante che il framework riempie.
Valore restituito
Nessuno
Osservazioni
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Per altre informazioni sul metodo WdfUsbInterfaceGetEndpointInformation e sulle destinazioni I/O USB, vedere Destinazioni I/O USB.
Esempi
L'esempio di codice seguente ottiene il numero di endpoint supportati da un'interfaccia USB e quindi chiama WdfUsbInterfaceGetEndpointInformation per ogni endpoint.
WDF_USB_PIPE_INFORMATION endPointInfo;
BYTE settingIndex, i;
settingIndex = 0;
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
UsbInterface,
settingIndex
);
for (i = 0; i < numEndpoints; i++){
WDF_USB_PIPE_INFORMATION_INIT(&endPointInfo);
WdfUsbInterfaceGetEndpointInformation(
UsbInterface,
settingIndex,
i,
&endPointInfo
);
//
// Examine endpoint information here.
//
...
}
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| versione minima di UMDF | 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) |