Método IWDFIoTarget::FormatRequestForIoctl (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 FormatRequestForIoctl da formato a un objeto de solicitud de E/S para una operación de control de E/S.
Sintaxis
HRESULT FormatRequestForIoctl(
[in] IWDFIoRequest *pRequest,
[in] ULONG IoctlCode,
[in, optional] IWDFFile *pFile,
[in, optional] IWDFMemory *pInputMemory,
[in, optional] PWDFMEMORY_OFFSET pInputMemoryOffset,
[in, optional] IWDFMemory *pOutputMemory,
[in, optional] PWDFMEMORY_OFFSET pOutputMemoryOffset
);
Parámetros
[in] pRequest
Puntero a la interfaz IWDFIoRequest para que el objeto de solicitud dé formato.
[in] IoctlCode
Código de control que identifica una operación específica que se va a realizar.
[in, optional] pFile
Puntero a la interfaz IWDFFile del objeto de archivo asociado a la solicitud de control de E/S. 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 de entrada de la solicitud. Este parámetro es opcional.
[in, optional] pInputMemoryOffset
Puntero a una estructura de WDFMEMORY_OFFSET que describe el desplazamiento de memoria de entrada de la solicitud. Este parámetro es opcional.
[in, optional] pOutputMemory
Puntero a la interfaz IWDFMemory que se usa para acceder al búfer de salida de la solicitud. Este parámetro es opcional.
[in, optional] pOutputMemoryOffset
Puntero a una estructura de WDFMEMORY_OFFSET que describe el desplazamiento de memoria de salida de la solicitud. Este parámetro es opcional.
Valor devuelto
FormatRequestForIoctl 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 |