Función WdfUsbTargetDeviceRetrieveCurrentFrameNumber (wdfusb.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfUsbTargetDeviceRetrieveCurrentFrameNumber recupera el número de fotograma USB actual.

Sintaxis

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

Parámetros

[in] UsbDevice

Identificador de un objeto de dispositivo USB obtenido de una llamada anterior a WdfUsbTargetDeviceCreateWithParameters.

[out] CurrentFrameNumber

Puntero a una ubicación que recibe el número de fotograma USB de 32 bits actual.

Valor devuelto

WdfUsbTargetDeviceRetrieveCurrentFrameNumber devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, este método puede devolver uno de los valores siguientes:

Código devuelto Descripción
STATUS_INVALID_PARAMETER
 Se ha detectado un parámetro no válido.
STATUS_UNSUCCESSFUL
 El número de fotograma no estaba disponible, posiblemente porque los controladores inferiores no proporcionan números de fotograma.
 

Este método también podría devolver otros valores NTSTATUS.

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Comentarios

Para obtener más información sobre el método WdfUsbTargetDeviceRetrieveCurrentFrameNumber y los destinos de E/S USB, consulte Destinos de E /S USB.

Ejemplos

En el ejemplo de código siguiente se llama a WdfUsbTargetDeviceRetrieveCurrentFrameNumber. En el ejemplo se obtiene un identificador de objeto de dispositivo USB del espacio de contexto definido por el controlador.

ULONG  frameNumber;
PMY_DEVICE_CONTEXT  pMyDeviceContext;

pMyDeviceContext = GetDeviceContext(Device);

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

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfusb.h (incluya Wdfusb.h)
Library Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL <=DISPATCH_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Consulte también

WdfUsbTargetDeviceCreateWithParameters