Funzione WdfUsbTargetDeviceRetrieveCurrentFrameNumber (wdfusb.h)

  • Articolo

[Si applica solo a KMDF]

Il metodo WdfUsbTargetDeviceRetrieveCurrentFrameNumber recupera il numero di frame USB corrente.

Sintassi

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

Parametri

[in] UsbDevice

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

[out] CurrentFrameNumber

Puntatore a una posizione che riceve il numero di frame 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 è disponibile, probabilmente perché i driver inferiori non forniscono numeri di frame.
 

Questo metodo potrebbe restituire anche altri valori NTSTATUS.

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Commenti

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

Esempio

Nell'esempio di codice seguente viene chiamato WdfUsbTargetDeviceRetrieveCurrentFrameNumber. Nell'esempio viene ottenuto un handle di oggetti dispositivo USB dallo spazio di contesto definito dal driver.

ULONG  frameNumber;
PMY_DEVICE_CONTEXT  pMyDeviceContext;

pMyDeviceContext = GetDeviceContext(Device);

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

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Intestazione wdfusb.h (include Wdfusb.h)
Libreria Wdf01000.sys (vedere Framework Library Versioning).
IRQL <=DISPATCH_LEVEL
Regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Vedi anche

WdfUsbTargetDeviceCreateWithParameters