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:

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

Siehe auch

WdfUsbTargetDeviceCreateWithParameters