Función WdfUsbTargetDeviceRetrieveCurrentFrameNumber (wdfusb.h)

[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