Compartir a través de


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

[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 FormatRequestForWrite da formato a un objeto de solicitud de E/S para una operación de escritura.

Sintaxis

HRESULT FormatRequestForWrite(
  [in]           IWDFIoRequest     *pRequest,
  [in, optional] IWDFFile          *pFile,
  [in, optional] IWDFMemory        *pInputMemory,
  [in, optional] PWDFMEMORY_OFFSET pInputMemoryOffset,
  [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 escritura. Para el destino de E/S predeterminado, este parámetro debe ser distinto de NULL.

[in, optional] pInputMemory

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

[in, optional] pInputMemoryOffset

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

[in, optional] DeviceOffset

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

Valor devuelto

FormatRequestForWrite 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

IWDFFile

IWDFIoRequest

IWDFIoTarget

IWDFMemory

WDFMEMORY_OFFSET