共用方式為

SerCxInitialize 函式 （sercx.h）

  • 發行項

SerCxInitialize 方法會在此驅動程式建立相關聯的裝置對象之後完成串行架構延伸模組 （SerCx） 的初始化。

語法

NTSTATUS SerCxInitialize(
  [in] WDFDEVICE     FxDevice,
  [in] PSERCX_CONFIG Config
);

參數

[in] FxDevice

代表序列控制器之架構裝置物件的WDFDEVICE句柄。

[in] Config

呼叫端配置的 SERCX_CONFIG 結構的指標，其中包含 SerCx 的組態資訊。 呼叫端先前呼叫 SERCX_CONFIG_INIT 函式，以初始化這個結構。

傳回值

如果成功，SerCxInitialize 會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列狀態代碼。

傳回碼 描述
STATUS_INVALID_DEVICE_REQUEST
 在錯誤的 IRQL 呼叫方法;或 WDFDEVICE 句柄無效;或 FxDevice 或 Config 為 NULL。
STATUS_INSUFFICIENT_RESOURCES
 無法配置系統資源（通常是記憶體）。

言論

序列控制器驅動程式會在建立相關聯的裝置對象之後呼叫這個方法。

SerCxInitialize 向 SerCx 註冊控制器驅動程式的 I/O 回呼函式。 此外，此方法會定義 I/O 佇列的傳輸模式。 在呼叫期間，此方法會建立 SerCx 所需的所有內部結構（包括序列控制器的 I/O 佇列）。 在此方法傳回之後，SerCx 已準備好處理 I/O。 不過，控制器驅動程式可能會先設定控制器硬體設定，再從 EvtDriverDeviceAdd 傳回 回呼，或將 PDO 新增至子清單之前。

如果參數無效（如 SERCX_CONFIG所述），驅動程式驗證器 將引發錯誤。

在認可裝置之前，必須先呼叫此例程（從 EvtDriverDeviceAdd 傳回 或將 PDO 新增至子清單）。

要求

要求 價值
最低支援的用戶端 從 Windows 8 開始提供。
目標平臺 普遍
標頭 sercx.h
IRQL PASSIVE_LEVEL

另請參閱

EvtDriverDeviceAdd

SERCX_CONFIG

SERCX_CONFIG_INIT