Método IWDFIoRequest::GetReadParameters (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 GetReadParameters recupera los parámetros de solicitud para una solicitud de tipo de lectura.

Sintaxis

void GetReadParameters(
  [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 leer. Para recuperar los datos para leerlos, el controlador llama al método IWDFIoRequest::GetOutputMemory .

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 leer desde el dispositivo o el archivo del dispositivo. Si el dispositivo no admite direcciones de lectura 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 ReadFile o ReadFileEx 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 GetReadParameters si el tipo de solicitud no es de lectura.

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.

Aunque el controlador puede especificar opcionalmente NULL para cada uno de los parámetros pSizeInBytes, pullOffset y pulKey , el controlador debe especificar al menos un parámetro distinto de NULL para que GetReadParameters se ejecute correctamente.

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

• IWDFIoRequest
• IWDFIoRequest::GetOutputMemory