SerCx2InitializeDeviceInit 函式（sercx.h）

發行項
10/30/2024

SerCx2InitializeDeviceInit 方法可讓序列架構延伸模組第 2 版（SerCx2）在建立序列控制器的架構裝置對象期間向驅動程式架構註冊擴充功能特定屬性。

語法

NTSTATUS SerCx2InitializeDeviceInit(
  [in, out] PWDFDEVICE_INIT DeviceInit
);

參數

[in, out] DeviceInit

WDFDEVICE_INIT 結構的指標，這是一種不透明的結構，可儲存核心模式驅動程序架構（KMDF）用來建立架構裝置物件的資訊。序列控制器驅動程式會接收此結構的指標，做為驅動程式 EvtDriverDeviceAdd 回呼函式的輸入參數。

傳回值

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

傳回碼	描述
STATUS_INVALID_DEVICE_REQUEST	方法在錯誤的 IRQL 上呼叫，或 DeviceInit 參數 NULL。
STATUS_INSUFFICIENT_RESOURCES	資源不足，無法執行要求的作業。

言論

序列控制器驅動程序必須先從其 EvtDriverDeviceAdd 回呼函式呼叫這個方法，才能為序列控制器建立 WDFDEVICE 物件。

SerCx2InitializeDeviceInit 將擴充功能特定資訊附加至驅動程式的 WDFDEVICE_INIT 結構。這項資訊可讓SerCx2代表序列控制器驅動程序執行特定動作。例如，SerCx2 會接收用戶端傳送至序列控制器的 I/O 要求。

序列控制器驅動程式必須先呼叫 SerCx2InitializeDeviceInit，才能建立架構裝置對象來代表序列控制器，以及呼叫 SerCx2InitializeDevice 方法來完成初始化裝置物件。驅動程式會呼叫 WdfDeviceCreate 等方法來建立裝置物件。

SerCx2InitializeDeviceInit 會設定預設的安全性描述元，讓內核模式驅動程式和使用者模式驅動程式將 I/O 要求傳送至 SerCx2。描述項只允許應用程式以系統管理員許可權執行時傳送這些要求。若要指定此描述元，SerCx2 會使用下列 SDDL 字串：

"D:P(A;;GA;;;SY)(A;;GA;;;BA)(A;;GA;;;UD)" 如有必要，序列控制器驅動程式可以使用所需的安全性描述元呼叫 WdfDeviceInitAssignSDDLString 方法來覆寫預設設定。驅動程式必須在呼叫 SerCx2InitializeDeviceInit 之後呼叫 WdfDeviceInitInitAssignSDDLString，但在呼叫 WdfDeviceCreate之前。如需 SDDL 字串的詳細資訊，請參閱裝置物件的 SDDL。