Función WdfIoQueueRetrieveRequestByFileObject (wdfio.h)

[Se aplica a KMDF y UMDF]

El método WdfIoQueueRetrieveRequestByFileObject recupera la siguiente solicitud de E/S disponible, de una cola de E/S especificada, que está asociada a un objeto de archivo especificado.

Sintaxis

NTSTATUS WdfIoQueueRetrieveRequestByFileObject(
  [in]  WDFQUEUE      Queue,
  [in]  WDFFILEOBJECT FileObject,
  [out] WDFREQUEST    *OutRequest
);

Parámetros

[in] Queue

Identificador de un objeto de cola de marco.

[in] FileObject

Identificador de un objeto de archivo de marco.

[out] OutRequest

Puntero a una ubicación que recibe un identificador de un objeto de solicitud de marco. Si WdfIoQueueRetrieveRequestByFileObject no devuelve STATUS_SUCCESS, no establece el valor de la ubicación.

Valor devuelto

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

Este método también puede devolver otros valores de NTSTATUS.

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

Observaciones

Un controlador que ha configurado una cola de E/S para el envío manual o secuencial podría llamar a WdfIoQueueRetrieveRequestByFileObject. Para obtener más información sobre el uso de WdfIoQueueRetrieveRequestByFileObject con los métodos de distribución manual o secuencial, vea Métodos de distribución para solicitudes de E/S.

Después de llamar a WdfIoQueueRetrieveRequestByFileObject para obtener una solicitud de E/S, el controlador posee la solicitud y debe procesar la solicitud de E/S de alguna manera.

Para obtener más información sobre el método WdfIoQueueRetrieveRequestByFileObject, vea Administración de colas de E/S.

Ejemplos

En el ejemplo de código siguiente se obtiene, de una cola de E/S especificada, un identificador para el siguiente objeto de solicitud de marco asociado a un objeto de archivo de marco especificado.

WDFREQUEST  request;

status = WdfIoQueueRetrieveRequestByFileObject(
                                               queue,
                                               fileObject,
                                               &request
                                               );

Requisitos

Consulte también

WdfIoQueueRetrieveFoundRequest

WdfIoQueueRetrieveNextRequest