структура SERCX_BUFFER_DESCRIPTOR (sercx.h)
Структура SERCX_BUFFER_DESCRIPTOR описывает буфер данных для операции получения или операции передачи.
Синтаксис
typedef struct SERCX_BUFFER_DESCRIPTOR {
USHORT Size;
PUCHAR Buffer;
ULONG Length;
} SERCX_BUFFER_DESCRIPTOR, *PSERCX_BUFFER_DESCRIPTOR;
Члены
Size
Размер этой структуры в байтах. Методы SerCxRetrieveReceiveBuffer и Методы SerCxRetrieveTransmitBuff er используют этот элемент, чтобы определить, какая версия структуры использует вызывающий объект. Размер этой структуры может измениться в будущих версиях файла заголовка Sercx.h.
Buffer
Адрес виртуальной памяти буфера. Память буфера не учитывается.
Length
Количество байтов, доступных в буфере. Этот размер определяет максимальное количество байтов, которые могут быть переданы операцией получения или передачи.
Замечания
Драйвер последовательного контроллера использует сведения в этой структуре, чтобы определить, где в памяти считываются данные во время операции получения и где в памяти записывать данные во время операции передачи.
В любое время не может быть более одного допустимого буфера приема и одного допустимого буфера передачи. Драйвер контроллера вызывает метод SerCxRetrieveReceiveBuffer для получения буфера получения и вызывает метод SerCxRetrieveTransmitBuffer для получения буфера передачи. Оба метода копируют описания буфера в структуры, выделенные вызывающим SERCX_BUFFER_DESCRIPTOR. Последующий вызов одного из этих методов делает недействительным ранее выданный дескриптор для буфера получения или буфера передачи соответственно. Вызывающий объект не должен получить доступ к буферу, описанному дескриптором буфера, который больше не является допустимым.
Буферы, полученные последовательными вызовами SerCxRetrieveReceiveBuffer или SerCxRetrieveTransmitBuffer, не гарантированы быть смежными.
Драйвер контроллера должен вызвать функцию SERCX_BUFFER_DESCRIPTOR_INIT, чтобы инициализировать структуру SERCX_BUFFER_DESCRIPTOR перед передачей структуры в метод SerCxRetrieveReceiveBuffer или Метод SerCxRetrieveTransmitBuffer. После инициализации дескриптора буфера его можно повторно использовать без инициализации повторно.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Поддерживается начиная с Windows 8. |
| заголовка | sercx.h |