Función SerCxRetrieveReceiveMdl (sercx.h)

El método SerCxRetrieveReceiveMdl recupera el MDL que describe el búfer que se va a usar para recibir el siguiente bloque de datos de entrada.

Sintaxis

NTSTATUS SerCxRetrieveReceiveMdl(
  [in]  WDFDEVICE Device,
  [out] PMDL      *Mdl
);

Parámetros

[in] Device

Un identificador WDFDEVICE para el objeto de dispositivo de marco que representa el controlador serie.

[out] Mdl

Puntero a una ubicación en la que el método escribe un puntero al MDL.

Valor devuelto

serCxRetrieveReceiveMdl devuelve STATUS_SUCCESS si la llamada se realiza correctamente. Los valores devueltos posibles incluyen los siguientes códigos de error.

Código devuelto

Descripción

STATUS_INVALID_DEVICE_REQUEST

Este valor se devuelve si se produce una de las siguientes acciones: No hay ninguna solicitud de recepción pendiente para obtener una MDL. El número actual de bytes recibidos (según lo indicado por el método SerCxProgressReceive) no es igual a cero. El búfer ya se ha recuperado (y aún no se ha producido la llamada correspondiente al método SerCxProgressReceive). Ya se ha recuperado la MDL (y aún no se ha producido la llamada correspondiente al método SerCxProgressReceive).

Observaciones

El controlador de controlador serie llama a esta función para obtener una MDL que se usará para la operación de recepción (lectura) actual. MdL describe la memoria del búfer en la que el controlador va a transferir los datos recibidos. El controlador es el propietario exclusivo de este MDL hasta que llama al método serCxProgressReceive, después del cual el puntero MDL no es válido y el controlador ya no debe intentar acceder a la MDL o a la memoria del búfer que describe el MDL.

Para obtener más información sobre las MDL, vea Using MDLs.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible a partir de Windows 8.
de la plataforma de destino de	Universal
encabezado de	sercx.h
irQL	<= DISPATCH_LEVEL

Consulte también

serCxProgressReceive