Función WdfRequestRetrieveUnsafeUserOutputBuffer (wdfrequest.h)

Artículo
02/07/2025

[Solo se aplica a KMDF]

El método WdfRequestRetrieveUnsafeUserOutputBuffer recupera el búfer de salida de una solicitud de E/S, si la técnica de la solicitud para obtener acceso a los búferes de datos no es ni búfer nide E/S directa.

Sintaxis

NTSTATUS WdfRequestRetrieveUnsafeUserOutputBuffer(
  [in]            WDFREQUEST Request,
  [in]            size_t     MinimumRequiredLength,
  [out]           PVOID      *OutputBuffer,
  [out, optional] size_t     *Length
);

Parámetros

[in] Request

Identificador de un objeto de solicitud de marco.

[in] MinimumRequiredLength

Tamaño mínimo del búfer, en bytes, que el controlador debe procesar la solicitud de E/S.

[out] OutputBuffer

Puntero a una ubicación que recibe la dirección del búfer.

[out, optional] Length

Puntero a una ubicación que recibe el tamaño del búfer, en bytes. Este parámetro es opcional y se puede NULL.

Valor devuelto

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

Código devuelto	Descripción
STATUS_INVALID_PARAMETER	Un parámetro de entrada no es válido.
STATUS_INVALID_DEVICE_REQUEST	Este valor se devuelve si se produce una de las siguientes acciones: No se llamó al método desde el EvtIoInCallerContext del controlador función de devolución de llamada. El código de control de E/S de la solicitud de E/S es IRP_MJ_WRITE o IRP_MJ_INTERNAL_DEVICE_CONTROL. La solicitud especifica de E/S almacenadas en búfer o de E/S directa.
STATUS_BUFFER_TOO_SMALL	El parámetro MinimumRequiredLength especifica un tamaño de búfer mayor que el tamaño real del búfer.

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

Se debe llamar al método WdfRequestRetrieveUnsafeUserOutputBuffer desde una función de devolución de llamada EvtIoInCallerContext. Después de llamar a WdfRequestRetrieveUnsafeUserOutputBuffer, el controlador debe llamar a WdfRequestProbeAndLockUserBufferForWrite.

El controlador puede llamar a WdfRequestRetrieveUnsafeUserOutputBuffer si el código de control de E/S de una solicitud es IRP_MJ_READ o IRP_MJ_DEVICE_CONTROL.

El controlador puede acceder al búfer recuperado hasta que complete la solicitud de E/S que representa el parámetro request de.

Para obtener más información sobre WdfRequestRetrieveUnsafeUserOutputBuffer, vea acceder a búferes de datos en controladores de Framework-Based.

Ejemplos

Para obtener un ejemplo de código que usa WdfRequestRetrieveUnsafeUserOutputBuffer, vea WdfRequestProbeAndLockUserBufferForRead.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
versión mínima de KMDF	1.0
encabezado de	wdfrequest.h (incluya Wdf.h)
biblioteca de	Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
irQL	PASSIVE_LEVEL
reglas de cumplimiento de DDI	BufAfterReqCompletedIntIoctl(kmdf), BufAfterReqCompletedIntIoctlA(kmdf), BufAfterReqCompletedIoctl(kmdf), BufAfterReqCompletedIoctlA(kmdf), BufAfterReqCompletedRead(kmdf), BufAfterReqCompletedReadA(() kmdf), BufAfterReqCompletedWrite(kmdf), DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), OutputBufferAPI(kmdf)

Consulte también

EvtIoInCallerContext

WdfRequestProbeAndLockUserBufferForWrite

WdfRequestRetrieveUnsafeUserInputBuffer

Compartir a través de