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

Artículo
08/08/2023

[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

Consulte también