SerCxDeviceInitConfig 函式 （sercx.h）
SerCxDeviceInitConfig 方法是由序列控制器驅動程式呼叫，以將串行架構延伸模組 （SerCx） 附加至它所建立之架構裝置物件 （FDO 或 PDO） 的 I/O 管線。
語法
NTSTATUS SerCxDeviceInitConfig(
[in, out] PWDFDEVICE_INIT DeviceInit
);
參數
[in, out] DeviceInit
要設定之 WDFDEVICE_INIT 結構的指標。
傳回值
如果呼叫成功，SerCxDeviceInitConfig 會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列狀態代碼。
| 傳回碼 | 描述 |
|---|---|
|
無法配置系統資源（通常是記憶體）。 |
言論
這個方法會將 SerCx 的組態資訊與所要建立之架構裝置物件 （PDO 或 FDO） 的 WDFDEVICE_INIT 結構產生關聯。 呼叫 SerCxDeviceInitConfig，再呼叫 WdfDeviceCreate 方法來建立裝置物件。
控制器驅動程式的 EvtDriverDeviceAdd 回呼函式會接收初始化 WDFDEVICE_INIT 結構的指標做為輸入參數。
SerCx 會設定串行控制器驅動程式可以視需要覆寫的預設安全性描述元。 例如，這個預設的安全性描述元可讓使用者模式驅動程式將 I/O 要求傳送至連接到序列控制器上埠的周邊裝置。 若要在安全性描述元中變更此設定，序列控制器驅動程式可以呼叫 WdfDeviceInitAssignSDDLString 方法。 這個呼叫必須發生在呼叫 SerCxDeviceInitConfig 之後，但在呼叫 WdfDeviceCreate 方法之前。
例子
在下列程式代碼範例中，控制器驅動程式的 EvtDriverDeviceAdd 回呼函式會將初始化的 WDFDEVICE_INIT 結構傳遞至 SerCxDeviceInitConfig 方法。 呼叫 SerCxDeviceInitConfig 之前，必須先 WdfDeviceCreate 呼叫，以建立序列控制器裝置 （UART） 的 FDO。
//
// FxDeviceInit is a pointer to an initialized WDFDEVICE_INIT structure.
// Drivers receive a pointer to this structure as an input parameter to an
// EvtDriverDeviceAdd callback function, or as a return value from the
// WdfControlDeviceInitAllocate method.
//
status = SerCxDeviceInitConfig(FxDeviceInit);
if (!NT_SUCCESS(status))
{
return status;
}
//
// Set WDF and SerCx device-level configuration options.
//
...
//
// Call the WdfDeviceCreate method.
//
...
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 8 開始提供。 |
| 目標平臺 | 普遍 |
| 標頭 | sercx.h |
| IRQL | PASSIVE_LEVEL |