WdfUsbTargetDeviceRetrieveCurrentFrameNumber-Funktion (wdfusb.h)

Artikel
02/27/2024

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

Weitere Informationen

WdfUsbTargetDeviceCreateWithParameters

Freigeben über