SERCX_CONFIG 구조체(sercx.h)

아티클
12/15/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 메서드를 호출하지 않는 한 컨트롤러 큐는 전원 관리되어야 합니다. 자세한 내용은 WDF_IO_QUEUE_CONFIGPowerManaged 멤버에 대한 설명을 참조하세요.

EvtSerCxFileOpen

컨트롤러 드라이버의 EvtSerCxFileOpen 콜백 함수에 대한 포인터입니다. 이 멤버는 선택 사항이며 NULL로 설정할 수 있습니다.

EvtSerCxFileClose

컨트롤러 드라이버의 EvtSerCxFileClose 콜백 함수에 대한 포인터입니다. 이 멤버는 선택 사항이며 NULL로 설정할 수 있습니다.

EvtSerCxFileCleanup

컨트롤러 드라이버의 EvtSerCxFileCleanup 콜백 함수에 대한 포인터입니다. 이 멤버는 선택 사항이며 NULL로 설정할 수 있습니다.

EvtSerCxTransmit

컨트롤러 드라이버의 EvtSerCxTransmit 콜백 함수에 대한 포인터입니다. 이 멤버는 유효한 콜백 함수를 가리키는 데 필요합니다.

EvtSerCxReceive

컨트롤러 드라이버의 EvtSerCxReceive 콜백 함수에 대한 포인터입니다. 이 멤버는 유효한 콜백 함수를 가리키는 데 필요합니다.

EvtSerCxWaitmask

컨트롤러 드라이버의 EvtSerCxWaitmask 콜백 함수에 대한 포인터입니다. 이 멤버는 유효한 콜백 함수를 가리키는 데 필요합니다.