SERCX2_CONFIG結構（sercx.h）

發行項
10/30/2024

SERCX2_CONFIG 結構包含序列架構延伸模組第 2 版的組態資訊（SerCx2）。

語法

typedef struct _SERCX2_CONFIG {
  ULONG                                            Size;
  PFN_SERCX2_FILEOPEN                              EvtSerCx2FileOpen;
  PFN_SERCX2_FILECLOSE                             EvtSerCx2FileClose;
  PFN_SERCX2_SET_WAIT_MASK                         EvtSerCx2SetWaitMask;
  PFN_SERCX2_PURGE_FIFOS                           EvtSerCx2PurgeFifos;
  PFN_SERCX2_CONTROL                               EvtSerCx2Control;
  PFN_SERCX2_APPLY_CONFIG                          EvtSerCx2ApplyConfig;
  PFN_SERCX2_SELECT_NEXT_RECEIVE_TRANSACTION_TYPE  EvtSerCx2SelectNextReceiveTransactionType;
  PFN_SERCX2_SELECT_NEXT_TRANSMIT_TRANSACTION_TYPE EvtSerCx2SelectNextTransmitTransactionType;
  PWDF_OBJECT_ATTRIBUTES                           RequestAttributes;
} SERCX2_CONFIG, *PSERCX2_CONFIG;

成員

Size

這個結構的大小，以位元組為單位。 SerCx2InitializeDevice 方法會使用此成員來判斷呼叫者所使用的結構版本。此結構的大小可能會在 Sercx.h 頭文件的未來版本中變更。

EvtSerCx2FileOpen

驅動程式實作 EvtSerCx2FileOpen 事件回呼函式的指標。這個成員是選擇性的，可以設定為 NULL，表示驅動程式不會實作函式。不過，實作此函式的驅動程式也必須實作 EvtSerCx2FileClose 函式。

EvtSerCx2FileClose

驅動程序實作 EvtSerCx2FileClose 事件回呼函式的指標。這個成員是選擇性的，可以設定為 NULL，表示驅動程式不會實作函式。

EvtSerCx2SetWaitMask

驅動程式實作 EvtSerCx2SetWaitmask 事件回呼函式的指標。這個成員必須指向有效的函式。

EvtSerCx2PurgeFifos

驅動程式實作 EvtSerCx2PurgeFifos 事件回呼函式的指標。這個成員必須指向有效的函式。

EvtSerCx2Control

驅動程序實作 EvtSerCx2Control 事件回呼函式的指標。這個成員必須指向有效的函式。

EvtSerCx2ApplyConfig

驅動程式實作 EvtSerCx2ApplyConfig 事件回呼函式的指標。這個成員必須指向有效的函式。

EvtSerCx2SelectNextReceiveTransactionType

驅動程式實作 EvtSerCx2SelectNextReceiveTransactionType 事件回呼函式的指標。這個成員是選擇性的，可以設定為 NULL，表示驅動程式不會實作函式。

EvtSerCx2SelectNextTransmitTransactionType

驅動程式實作 EvtSerCx2SelectNextTransmitTransactionType 事件回呼函式的指標。這個成員是選擇性的，可以設定為 NULL，表示驅動程式不會實作函式。

RequestAttributes

WDF_OBJECT_ATTRIBUTES 結構的指標，描述要指派給SerCx2 傳遞給序列控制器驅動程式之架構要求對象的屬性。呼叫 SerCx2InitializeDevice 方法之前，呼叫端必須呼叫 WDF_OBJECT_ATTRIBUTES_INIT 函式來初始化結構。這個成員是選擇性的，如果序列控制器驅動程式不需要將屬性指派給物件，則可以指定為WDF_NO_OBJECT_ATTRIBUTES。如需詳細資訊，請參閱。

言論

SerCx2InitializeDevice 方法接受 SERCX2_CONFIG 結構的指標做為輸入參數。呼叫 SerCx2InitializeDevice之前，請先呼叫 SERCX2_CONFIG_INIT 函式來初始化這個結構。

如果 RequestAttributes 成員指向 WDF_OBJECT_ATTRIBUTES 結構，呼叫端不得覆寫 WDF_OBJECT_ATTRIBUTES_INIT 初始化函式寫入 ParentObject、ExecutionLevel，以及 SynchronizationScope 成員這個結構的值。

驅動程式可能需要將資訊儲存在驅動程式所接收之架構要求對象的內容區域中。驅動程式通常會呼叫 WdfDeviceInitSetRequestAttributes 方法來指定要求物件的必要屬性。這些屬性包括每個要求物件中內容區域的名稱和大小。此外，在 SerCx2 的目前實作中，需要要求內容的序列控制器驅動程式應該在 RequestAttributes 中指定這些相同的屬性， 驅動程式傳遞給 SerCx2InitializeDevice之 SERCX2_CONFIG 結構的成員。也就是說，驅動程式應該在 SerCx2InitializeDevice 呼叫中，以及在 WdfDeviceInitSetRequestAttributes 呼叫中指定相同的要求屬性。如需詳細資訊，請參閱 SerCx2 Custom-Receive Transactions 和 SerCx2 Custom-Transmit Transactions。

永遠不需要要求內容的驅動程式不需要呼叫 WdfDeviceInitSetRequestAttributes，而且可以將 SERCX2_CONFIG 結構成員的 RequestAttributes 設定為 WDF_NO_OBJECT_ATTRIBUTES。