Função WdfIoQueueRetrieveNextRequest (wdfio.h)

[Aplica-se a KMDF e UMDF]

O método WdfIoQueueRetrieveNextRequest recupera a próxima solicitação de E/S disponível de uma fila de E/S especificada.

Sintaxe

NTSTATUS WdfIoQueueRetrieveNextRequest(
  [in]  WDFQUEUE   Queue,
  [out] WDFREQUEST *OutRequest
);

Parâmetros

[in] Queue

Um identificador para um objeto de fila de estrutura.

[out] OutRequest

Um ponteiro para um local que recebe um identificador para um objeto de solicitação de estrutura. Se a fila estiver vazia ou a última solicitação tiver sido recuperada, esse parâmetro receberá NULL.

Valor de retorno

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

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

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

Observações

Se um driver configurar uma fila de E/S para expedição manual de solicitações de E/S, o driver normalmente chama WdfIoQueueRetrieveNextRequest para obter solicitações da fila. Um driver que configurou uma fila de E/S para expedição sequencial também pode chamar WdfIoQueueRetrieveNextRequest. Para obter mais informações sobre como usar WdfIoQueueRetrieveNextRequest com os métodos de expedição manual ou sequencial, consulte Métodos de Expedição para Solicitações de E/S.

Depois de chamar WdfIoQueueRetrieveNextRequest para obter uma solicitação de E/S, o de driver é proprietário solicitação e deve processar o de solicitação de E/S de alguma maneira.

Para obter mais informações sobre o método WdfIoQueueRetrieveNextRequest, consulte Gerenciando filas de E/S.

Exemplos

O exemplo de código a seguir obtém um identificador para o próximo objeto de solicitação contido na fila de E/S de um dispositivo.

NTSTATUS  status;
WDFREQUEST  request;

status = WdfIoQueueRetrieveNextRequest(
                                       pDeviceContext->ReadQueue,
                                       &request
                                       );

Requisitos

Consulte também

WdfIoQueueRetrieveFoundRequest

WdfIoQueueRetrieveRequestByFileObject