Função WdfUsbTargetDeviceRetrieveCurrentFrameNumber (wdfusb.h)

  • Artigo

[Aplica-se somente ao KMDF]

O método WdfUsbTargetDeviceRetrieveCurrentFrameNumber recupera o número de quadro USB atual.

Sintaxe

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

Parâmetros

[in] UsbDevice

Um identificador para um objeto de dispositivo USB que foi obtido de uma chamada anterior para WdfUsbTargetDeviceCreateWithParameters.

[out] CurrentFrameNumber

Um ponteiro para um local que recebe o número de quadro USB atual de 32 bits.

Retornar valor

WdfUsbTargetDeviceRetrieveCurrentFrameNumber retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método pode retornar um dos seguintes valores:

Código de retorno Descrição
STATUS_INVALID_PARAMETER
 Um parâmetro inválido foi detectado.
STATUS_UNSUCCESSFUL
 O número do quadro não estava disponível, possivelmente porque os drivers inferiores não fornecem números de quadro.
 

Esse método também pode retornar outros valores NTSTATUS.

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

Para obter mais informações sobre o método WdfUsbTargetDeviceRetrieveCurrentFrameNumber e destinos de E/S USB, consulte Destinos de E/S USB.

Exemplos

O exemplo de código a seguir chama WdfUsbTargetDeviceRetrieveCurrentFrameNumber. O exemplo obtém um identificador de objeto de dispositivo USB do espaço de contexto definido pelo driver.

ULONG  frameNumber;
PMY_DEVICE_CONTEXT  pMyDeviceContext;

pMyDeviceContext = GetDeviceContext(Device);

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

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Cabeçalho wdfusb.h (include Wdfusb.h)
Biblioteca Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL <=DISPATCH_LEVEL
Regras de conformidade da DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Confira também

WdfUsbTargetDeviceCreateWithParameters