Compartir a través de

Método IWDFIoRequest::GetWriteParameters (wudfddi.h)

  • Artículo

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 GetWriteParameters recupera los parámetros de solicitud para una solicitud de tipo de escritura.

Sintaxis

void GetWriteParameters(
  [out, optional] SIZE_T   *pSizeInBytes,
  [out, optional] LONGLONG *pullOffset,
  [out, optional] ULONG    *pulKey
);

Parámetros

[out, optional] pSizeInBytes

Puntero a una variable que recibe el tamaño, en bytes, que se va a escribir. Para recuperar los datos para escribirlos, el controlador llama al método IWDFIoRequest::GetInputMemory .

Este parámetro es opcional. El controlador puede pasar NULL si no requiere la información.

[out, optional] pullOffset

Puntero a una variable que recibe el desplazamiento, en bytes, para empezar a escribir en el dispositivo o en el archivo del dispositivo. Si el dispositivo no admite direcciones de escritura absolutas, se puede omitir pullOffset . Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Las aplicaciones cliente especifican este valor en los miembros Offset y OffsetHigh de la estructura SUPERPUESTA. Se pasa un puntero a OVERLAPPED en la función WriteFile o WriteFileEx de Microsoft Win32.

Este parámetro es opcional. El controlador puede pasar NULL si no requiere la información.

[out, optional] pulKey

Puntero a una variable que recibe una clave que el controlador puede usar para ordenar la solicitud de E/S de una manera que determina el controlador.

Este parámetro es opcional. El controlador puede pasar NULL si no requiere la información.

Valor devuelto

None

Observaciones

Se produce un error en una llamada a GetWriteParameters si el tipo de solicitud no es un tipo de escritura.

En el caso de los dispositivos que admiten el direccionamiento (por ejemplo, un dispositivo de disco), el valor al que apunta el parámetro pullOffset suele ser el desplazamiento de bytes en el dispositivo. En el caso de los dispositivos que no admiten el direccionamiento (por ejemplo, un puerto serie), el controlador puede omitir el valor en pullOffset.

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