Método IWDFIoTarget::FormatRequestForRead (wudfddi.h)

Artículo
02/27/2024

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

El método FormatRequestForRead da formato a un objeto de solicitud de E/S para una operación de lectura.

Sintaxis

HRESULT FormatRequestForRead(
  [in]           IWDFIoRequest     *pRequest,
  [in, optional] IWDFFile          *pFile,
  [in, optional] IWDFMemory        *pOutputMemory,
  [in, optional] PWDFMEMORY_OFFSET pOutputMemoryOffset,
  [in, optional] PLONGLONG         DeviceOffset
);

Parámetros

[in] pRequest

Puntero a la interfaz IWDFIoRequest para que el objeto de solicitud dé formato.

[in, optional] pFile

Puntero a la interfaz IWDFFile del objeto de archivo asociado a la solicitud de lectura. Para el destino de E/S predeterminado, este parámetro debe ser distinto de NULL.

[in, optional] pOutputMemory

Puntero a la interfaz IWDFMemory que se usa para acceder al búfer que se usa para la solicitud de lectura. Este parámetro es opcional.

[in, optional] pOutputMemoryOffset

Puntero a una estructura de WDFMEMORY_OFFSET que describe el desplazamiento de memoria de salida que se usa para la lectura. Este parámetro es opcional.

[in, optional] DeviceOffset

Puntero al desplazamiento del dispositivo que se usa para la lectura. Este parámetro es opcional.

Valor devuelto

FormatRequestForRead devuelve S_OK si la operación se realiza correctamente. De lo contrario, este método devuelve uno de los códigos de error definidos en Winerror.h.

Requisitos

Requisito	Value
Finalización del soporte técnico	No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino	Escritorio
Versión mínima de UMDF	1.5
Encabezado	wudfddi.h (incluya Wudfddi.h)
Archivo DLL	WUDFx.dll

Consulte también

Compartir a través de