WdfUsbInterfaceGetEndpointInformation-Funktion (wdfusb.h)
[Gilt für KMDF und UMDF]
Die WdfUsbInterfaceGetEndpointInformation-Methode ruft Informationen zu einem angegebenen USB-Geräteendpunkt und der zugehörigen Pipe ab.
Syntax
void WdfUsbInterfaceGetEndpointInformation(
[in] WDFUSBINTERFACE UsbInterface,
[in] UCHAR SettingIndex,
[in] UCHAR EndpointIndex,
[in, out] PWDF_USB_PIPE_INFORMATION EndpointInfo
);
Parameter
[in] UsbInterface
Ein Handle für ein USB-Schnittstellenobjekt, das durch aufrufen von WdfUsbTargetDeviceGetInterface abgerufen wurde.
[in] SettingIndex
Ein Indexwert, der eine alternative Einstellung für die Schnittstelle identifiziert. Weitere Informationen zu alternativen Einstellungen finden Sie in der USB-Spezifikation.
[in] EndpointIndex
Ein Indexwert, der einen Endpunkt identifiziert, der der angegebenen alternativen Einstellung der angegebenen Schnittstelle zugeordnet ist. (Dieser Indexwert ist nicht die Endpunktadresse.)
[in, out] EndpointInfo
Ein Zeiger auf eine vom Aufrufer zugewiesene WDF_USB_PIPE_INFORMATION Struktur, die das Framework ausfüllt.
Rückgabewert
Keine
Bemerkungen
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Weitere Informationen zur WdfUsbInterfaceGetEndpointInformation-Methode und USB-E/A-Zielen finden Sie unter USB-E/A-Ziele.
Beispiele
Im folgenden Codebeispiel wird die Anzahl der Von einer USB-Schnittstelle unterstützten Endpunkte abgerufen und dann WdfUsbInterfaceGetEndpointInformation für jeden Endpunkt aufgerufen.
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.
//
...
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfusb.h (einschließlich Wdfusb.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |