структура SERCX_CONFIG (sercx.h)

Статья
12/13/2024

Структура SERCX_CONFIG содержит сведения о конфигурации для расширения последовательной платформы (SerCx).

Синтаксис

typedef struct _SERCX_CONFIG {
  ULONG                     Size;
  WDF_TRI_STATE             PowerManaged;
  PFN_SERCX_FILEOPEN        EvtSerCxFileOpen;
  PFN_SERCX_FILECLOSE       EvtSerCxFileClose;
  PFN_SERCX_FILECLEANUP     EvtSerCxFileCleanup;
  PFN_SERCX_TRANSMIT        EvtSerCxTransmit;
  PFN_SERCX_RECEIVE         EvtSerCxReceive;
  PFN_SERCX_WAITMASK        EvtSerCxWaitmask;
  PFN_SERCX_PURGE           EvtSerCxPurge;
  PFN_SERCX_CONTROL         EvtSerCxControl;
  PFN_SERCX_APPLY_CONFIG    EvtSerCxApplyConfig;
  PFN_SERCX_TRANSMIT_CANCEL EvtSerCxTransmitCancel;
  PFN_SERCX_RECEIVE_CANCEL  EvtSerCxReceiveCancel;
} SERCX_CONFIG, *PSERCX_CONFIG;

Члены

Size

Размер этой структуры в байтах. Метод SerCxInitialize использует этот элемент для определения версии структуры, которую использует вызывающий объект. Размер этой структуры может измениться в будущих версиях файла заголовка Sercx.h.

PowerManaged

Должна ли очередь контроллера управлять питанием. Если задано значение WdfTrue, очередь контроллера должна управляться питанием. Если задано значение WdfFalse, очередь контроллера не управляется питанием. Если задано значение WdfDefault, очередь контроллера должна управляться питанием, если драйвер не вызывает метод WdfFdoInitSetFilter. Дополнительные сведения см. в описании элемента PowerManaged в WDF_IO_QUEUE_CONFIG.

EvtSerCxFileOpen

Указатель на драйвера контроллера функцию обратного вызова EvtSerCxFileOpen. Этот член является необязательным и может иметь значение NULL.

EvtSerCxFileClose

Указатель на функцию обратного вызова драйвера контроллера EvtSerCxFileClose. Этот член является необязательным и может иметь значение NULL.

EvtSerCxFileCleanup

Указатель на функцию обратного вызова драйвера контроллера EvtSerCxFileCleanup. Этот член является необязательным и может иметь значение NULL.

EvtSerCxTransmit

Указатель на функцию обратного вызова драйвера контроллера EvtSerCxTransmit. Этот элемент необходим для указания допустимой функции обратного вызова.

EvtSerCxReceive

Указатель на функцию обратного вызова драйвера контроллера EvtSerCxReceive. Этот элемент необходим для указания допустимой функции обратного вызова.

EvtSerCxWaitmask

Указатель на функцию обратного вызова драйвера контроллера EvtSerCxWaitmask. Этот элемент необходим для указания допустимой функции обратного вызова.

EvtSerCxPurge

Указатель на функцию обратного вызова драйвера контроллера EvtSerCxPurge. Этот член является необязательным и может иметь значение NULL.

EvtSerCxControl

Указатель на функцию обратного вызова драйвера контроллера EvtSerCxControl. Этот элемент необходим для указания допустимой функции обратного вызова.

EvtSerCxApplyConfig

Указатель на функцию обратного вызова драйвера контроллера EvtSerCxApplyConfig. Этот элемент необходим для указания допустимой функции обратного вызова.

EvtSerCxTransmitCancel

Указатель на функцию обратного вызова драйвера контроллера EvtSerCxTransmitCancel. Этот член является необязательным и может иметь значение NULL.

EvtSerCxReceiveCancel

Указатель на функцию обратного вызова драйвера контроллера EvtSerCxReceiveCancel. Этот член является необязательным и может иметь значение NULL.

Замечания

Прежде чем эта структура передается в метод SerCxInitialize, она должна быть инициализирована функцией SERCX_CONFIG_INIT, а затем изменена драйвером контроллера, чтобы задать указатели функции обратного вызова и элемент PowerManaged.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается начиная с Windows 8.
заголовка	sercx.h