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 WdfUsbTargetDeviceCreateWithParametersabgerufen 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 angeben. |
Diese Methode kann auch andere NTSTATUS-Wertezurückgeben.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Weitere Informationen zu den WdfUsbTargetDeviceRetrieveCurrentFrameNumber Methode und USB-E/A-Zielen finden Sie unter USB-E/A-Ziele.
Beispiele
Im folgenden Codebeispiel wird WdfUsbTargetDeviceRetrieveCurrentFrameNumberaufgerufen. 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- | Universal |
Minimale KMDF-Version | 1.0 |
Header- | wdfusb.h (include Wdfusb.h) |
Library | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
IRQL- | <=DISPATCH_LEVEL |
DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |