Funzione WdfUsbTargetDeviceRetrieveCurrentFrameNumber (wdfusb.h)

Articolo
02/07/2025

[Si applica solo a KMDF]

Il metodo WdfUsbTargetDeviceRetrieveCurrentFrameNumber recupera il numero di fotogramma USB corrente.

Sintassi

NTSTATUS WdfUsbTargetDeviceRetrieveCurrentFrameNumber(
  [in]  WDFUSBDEVICE UsbDevice,
  [out] PULONG       CurrentFrameNumber
);

Parametri

[in] UsbDevice

Handle per un oggetto dispositivo USB ottenuto da una chiamata precedente a WdfUsbTargetDeviceCreateWithParameters.

[out] CurrentFrameNumber

Puntatore a una posizione che riceve il numero di fotogramma USB a 32 bit corrente.

Valore restituito

WdfUsbTargetDeviceRetrieveCurrentFrameNumber restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo può restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	È stato rilevato un parametro non valido.
STATUS_UNSUCCESSFUL	Il numero di frame non era disponibile, probabilmente perché i driver inferiori non forniscono numeri di fotogramma.

Questo metodo potrebbe anche restituire altri valori NTSTATUS .

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Osservazioni

Per altre informazioni sul metodo WdfUsbTargetDeviceRetrieveCurrentFrameNumber e sulle destinazioni di I/O USB, vedere Destinazioni I/O USB.

Esempi

L'esempio di codice seguente chiama WdfUsbTargetDeviceRetrieveCurrentFrameNumber. L'esempio ottiene un handle di oggetto dispositivo USB dallo spazio di contesto definito dal driver.

ULONG  frameNumber;
PMY_DEVICE_CONTEXT  pMyDeviceContext;

pMyDeviceContext = GetDeviceContext(Device);

status = WdfUsbTargetDeviceRetrieveCurrentFrameNumber(
                                              pMyDeviceContext->UsbTargetDevice,
                                              &frameNumber
                                              );

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
intestazione	wdfusb.h (include Wdfusb.h)
libreria	Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL	<=DISPATCH_LEVEL
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Vedere anche

WdfUsbTargetDeviceCreateWithParameters

Condividi tramite