Compartir a través de

Función SerCxRetrieveReceiveBuffer (sercx.h)

  • Artículo

El método SerCxRetrieveReceiveBuffer obtiene un búfer de entrada en el que se pueden cargar los datos recibidos del puerto serie.

Sintaxis

NTSTATUS SerCxRetrieveReceiveBuffer(
  [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 SerCxRetrieveReceiveBuffer se realiza correctamente, el autor de la llamada recibe un búfer de entrada que contiene hasta Longitud bytes de espacio disponible. (El espacio disponible en el búfer puede ser menor que Longitud bytes). SerCxRetrieveReceiveBuffer escribe el número real de bytes de espacio disponible 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 recepció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

serCxRetrieveReceiveBuffer 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 recepció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 para contener datos de entrada de la operación de recepción (lectura) 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