WdfUsbTargetDeviceRetrieveCurrentFrameNumber-Funktion (wdfusb.h)
[Gilt nur für KMDF]
Die WdfUsbTargetDeviceRetrieveCurrentFrameNumber-Methode ruft die aktuelle USB-Framenummer ab.
Syntax
NTSTATUS WdfUsbTargetDeviceRetrieveCurrentFrameNumber(
[in] WDFUSBDEVICE UsbDevice,
[out] PULONG CurrentFrameNumber
);
Parameter
[in] UsbDevice
Ein Handle für ein USB-Geräteobjekt, das aus einem vorherigen Aufruf von WdfUsbTargetDeviceCreateWithParameters abgerufen wurde.
[out] CurrentFrameNumber
Ein Zeiger auf eine Position, die die aktuelle 32-Bit-USB-Framenummer empfängt.
Rückgabewert
WdfUsbTargetDeviceRetrieveCurrentFrameNumber gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls kann diese Methode einen der folgenden Werte zurückgeben:
| Rückgabecode | Beschreibung |
|---|---|
|
Ein ungültiger Parameter wurde erkannt. |
|
Die Framenummer war nicht verfügbar, möglicherweise weil niedrigere Treiber keine Framenummern bereitstellen. |
Diese Methode kann auch andere NTSTATUS-Werte zurückgeben.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Weitere Informationen zur WdfUsbTargetDeviceRetrieveCurrentFrameNumber-Methode und USB-E/A-Zielen finden Sie unter USB-E/A-Ziele.
Beispiele
Im folgenden Codebeispiel wird WdfUsbTargetDeviceRetrieveCurrentFrameNumber aufgerufen. Im Beispiel wird ein USB-Geräteobjekthandle aus dem vom Treiber definierten Kontextbereich abgerufen.
ULONG frameNumber;
PMY_DEVICE_CONTEXT pMyDeviceContext;
pMyDeviceContext = GetDeviceContext(Device);
status = WdfUsbTargetDeviceRetrieveCurrentFrameNumber(
pMyDeviceContext->UsbTargetDevice,
&frameNumber
);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfusb.h (wdfusb.h einschließen) |
| Bibliothek | Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |