Compartir a través de

Función SerCxRetrieveTransmitBuffer (sercx.h)

  • Artículo

El método SerCxRetrieveTransmitBuffer obtiene un búfer de salida que contiene datos que están listos para transmitirse al puerto serie.

Sintaxis

NTSTATUS SerCxRetrieveTransmitBuffer(
  [in]      WDFDEVICE                Device,
  [in]      ULONG                    Length,
  [in, out] PSERCX_BUFFER_DESCRIPTOR BufferDescriptor
);

Parámetros

[in] Device

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

[in] Length

Longitud del búfer solicitada, en bytes. Si la llamada de SerCxRetrieveTransmitBuffer se realiza correctamente, el autor de la llamada recibe un búfer de salida que contiene hasta Longitud bytes de datos disponibles. (Los datos disponibles en el búfer pueden ser menores que Longitud bytes). SerCxRetrieveTransmitBuffer escribe el número real de bytes de datos disponibles en el miembro Length de la estructura a la que apunta el parámetro bufferDescriptor .

[in, out] BufferDescriptor

Puntero a una estructura de SERCX_BUFFER_DESCRIPTOR asignada por el autor de la llamada. Esta estructura describe el búfer de datos que se va a usar para la operación de transmisión. El autor de la llamada anteriormente llamó a la función SERCX_BUFFER_DESCRIPTOR_INIT para inicializar esta estructura. los serCxRetrieveTransmitBuffer escriben en el de búfer de y miembros de longitud de esta estructura.

Valor devuelto

serCxRetrieveTransmitBuffer devuelve STATUS_SUCCESS si se realiza correctamente. Entre los posibles valores devueltos de error se incluyen los siguientes códigos de estado.

Código devuelto Descripción
STATUS_INVALID_DEVICE_REQUEST
 Se llamó al método en irQL incorrecto; o el identificador WDFDEVICE no es válido; o bien de dispositivo o bufferDescriptor es NULL; o el controlador ya tiene un búfer de transmisión.
STATUS_INFO_LENGTH_MISMATCH
 El tamaño incorrecto se especifica para la estructura de SERCX_BUFFER_DESCRIPTOR.
STATUS_INSUFFICIENT_RESOURCES
 No se pudieron asignar recursos del sistema (normalmente memoria).

Observaciones

El controlador del controlador serie llama a este método para adquirir un búfer que contiene los datos de salida para la operación de transmisión (escritura) actual.

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

SERCX_BUFFER_DESCRIPTOR

SERCX_BUFFER_DESCRIPTOR_INIT