Función SerCxRetrieveTransmitMdl (sercx.h)

El método SerCxRetrieveTransmitMdl recupera la MDL que describe el búfer que contiene el siguiente bloque de datos de salida que se van a transmitir.

Sintaxis

NTSTATUS SerCxRetrieveTransmitMdl(
  [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

serCxRetrieveTransmitMdl 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 transmisión pendiente para obtener una MDL. El número actual de bytes transmitidos (según lo notificado por el método SerCxProgressTransmit) 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 SerCxProgressTransmit). El MDL ya se ha recuperado (y aún no se ha producido la llamada correspondiente al método SerCxProgressTransmit).

Observaciones

El controlador del controlador serie llama a esta función para obtener una MDL que se usará para la operación de transmisión (escritura) actual. El MDL describe la memoria del búfer desde la que el controlador va a obtener los datos que se van a transmitir. El controlador es el propietario exclusivo de este MDL hasta que llama al método SerCxProgressTransmit, 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

serCxProgressTransmit