WdfUsbTargetDeviceRetrieveCurrentFrameNumber-Funktion (wdfusb.h)

Artikel
02/07/2025

[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
STATUS_INVALID_PARAMETER	Ein ungültiger Parameter wurde erkannt.
STATUS_UNSUCCESSFUL	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)

Siehe auch

WdfUsbTargetDeviceCreateWithParameters

Freigeben über