SERCX_CONFIG-Struktur (sercx.h)

Artikel
08/07/2023

Die SERCX_CONFIG-Struktur enthält Konfigurationsinformationen für die serielle Frameworkerweiterung (SerCx).

Syntax

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;

Member

Size

Die Größe (in Bytes) dieser Struktur. Die SerCxInitialize-Methode verwendet diesen Member, um zu bestimmen, welche Version der Struktur der Aufrufer verwendet. Die Größe dieser Struktur kann sich in zukünftigen Versionen der Sercx.h-Headerdatei ändern.

PowerManaged

Gibt an, ob die Controllerwarteschlange energieverwaltet werden soll. Wenn sie auf WdfTrue festgelegt ist, sollte die Controllerwarteschlange energieverwaltet sein. Wenn diese Option auf WdfFalse festgelegt ist, wird die Controllerwarteschlange nicht energieverwaltet. Wenn die Einstellung auf WdfDefault festgelegt ist, sollte die Controllerwarteschlange energieverwaltet werden, es sei denn, der Treiber ruft die WdfFdoInitSetFilter-Methode auf. Weitere Informationen finden Sie in der Beschreibung des PowerManaged-Elements in WDF_IO_QUEUE_CONFIG.

EvtSerCxFileOpen

Ein Zeiger auf die EvtSerCxFileOpen-Rückruffunktion des Controllertreibers. Dieser Member ist optional und kann auf NULL festgelegt werden.

EvtSerCxFileClose

Ein Zeiger auf die EvtSerCxFileClose-Rückruffunktion des Controllertreibers. Dieser Member ist optional und kann auf NULL festgelegt werden.

EvtSerCxFileCleanup

Ein Zeiger auf die EvtSerCxFileCleanup-Rückruffunktion des Controllertreibers. Dieser Member ist optional und kann auf NULL festgelegt werden.

EvtSerCxTransmit

Ein Zeiger auf die EvtSerCxTransmit-Rückruffunktion des Controllertreibers. Dieser Member ist erforderlich, um auf eine gültige Rückruffunktion zu verweisen.

EvtSerCxReceive

Ein Zeiger auf die EvtSerCxReceive-Rückruffunktion des Controllertreibers. Dieser Member ist erforderlich, um auf eine gültige Rückruffunktion zu verweisen.

EvtSerCxWaitmask

Ein Zeiger auf die EvtSerCxWaitmask-Rückruffunktion des Controllertreibers. Dieser Member ist erforderlich, um auf eine gültige Rückruffunktion zu verweisen.

EvtSerCxPurge

Ein Zeiger auf die EvtSerCxPurge-Rückruffunktion des Controllertreibers. Dieser Member ist optional und kann auf NULL festgelegt werden.

EvtSerCxControl

Ein Zeiger auf die EvtSerCxControl-Rückruffunktion des Controllertreibers. Dieser Member ist erforderlich, um auf eine gültige Rückruffunktion zu verweisen.

EvtSerCxApplyConfig

Ein Zeiger auf die EvtSerCxApplyConfig-Rückruffunktion des Controllertreibers. Dieser Member ist erforderlich, um auf eine gültige Rückruffunktion zu verweisen.

EvtSerCxTransmitCancel

Ein Zeiger auf die EvtSerCxTransmitCancel-Rückruffunktion des Controllertreibers. Dieser Member ist optional und kann auf NULL festgelegt werden.

EvtSerCxReceiveCancel

Ein Zeiger auf die EvtSerCxReceiveCancel-Rückruffunktion des Controllertreibers. Dieser Member ist optional und kann auf NULL festgelegt werden.

Hinweise

Bevor diese Struktur an die SerCxInitialize-Methode übergeben wird, muss sie von der SERCX_CONFIG_INIT-Funktion initialisiert und dann vom Controllertreiber geändert werden, um die Rückruffunktionszeiger und den PowerManaged-Member festzulegen.