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

Статья
08/07/2023

Структура 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 .