estructura SERCX_BUFFER_DESCRIPTOR (sercx.h)
La estructura SERCX_BUFFER_DESCRIPTOR describe un búfer de datos para una operación de recepción o una operación de transmisión.
Sintaxis
typedef struct SERCX_BUFFER_DESCRIPTOR {
USHORT Size;
PUCHAR Buffer;
ULONG Length;
} SERCX_BUFFER_DESCRIPTOR, *PSERCX_BUFFER_DESCRIPTOR;
Miembros
Size
Tamaño, en bytes, de esta estructura. Los métodos SerCxRetrieveReceiveBuffer y SerCxRetrieveTransmitBuffer usan este miembro para determinar qué versión de la estructura está usando el autor de la llamada. El tamaño de esta estructura puede cambiar en versiones futuras del archivo de encabezado Sercx.h.
Buffer
Dirección de memoria virtual del búfer. La memoria del búfer no está paginada.
Length
Número de bytes disponibles en el búfer. Este tamaño determina el número máximo de bytes que la operación de recepción o transmisión puede transferir.
Observaciones
El controlador del controlador serie usa la información de esta estructura para determinar dónde en memoria leer datos durante una operación de recepción y dónde en memoria escribir datos durante una operación de transmisión.
En cualquier momento, no puede haber más de un búfer de recepción válido y un búfer de transmisión válido. El controlador del controlador llama al método SerCxRetrieveReceiveBuffer para obtener el búfer de recepción y llama al método SerCxRetrieveTransmitBuffer para obtener el búfer de transmisión. Ambos métodos copian descripciones del búfer en estructuras de SERCX_BUFFER_DESCRIPTOR asignadas por el autor de la llamada. Una llamada posterior a uno de estos métodos invalida el descriptor emitido anteriormente para el búfer de recepción o el búfer de transmisión, respectivamente. El autor de la llamada no debe tener acceso a un búfer descrito por un descriptor de búfer que ya no sea válido.
No se garantiza que los búferes obtenidos por llamadas sucesivas a SerCxRetrieveReceiveBuffer o SerCxRetrieveTransmitBuffer sean contiguos.
El controlador del controlador debe llamar a la función SERCX_BUFFER_DESCRIPTOR_INIT para inicializar una estructura de SERCX_BUFFER_DESCRIPTOR antes de pasar la estructura al método SerCxRetrieveReceiveBuffer o SerCxRetrieveTransmitBuffer. Después de inicializar un descriptor de búfer, se puede reutilizar sin volver a inicializarse.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Se admite a partir de Windows 8. |
| encabezado de |
sercx.h |