NetConfigurationOpenSubConfiguration 函式 (netconfiguration.h)
開啟指定之配接器組態物件的子組態。
語法
NTSTATUS NetConfigurationOpenSubConfiguration(
[_In_] NETCONFIGURATION Configuration,
[_In_] PCUNICODE_STRING SubConfigurationName,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *SubConfigurationAttributes,
[_Out_] NETCONFIGURATION *SubConfiguration
);
參數
[_In_] Configuration
在呼叫 NetAdapterOpenConfiguration 或 NetConfigurationOpenSubConfiguration 之前開啟之配接器組態物件的句柄。
[_In_] SubConfigurationName
字串的指標，指定要開啟之子組態的名稱。
[_In_opt_] SubConfigurationAttributes
WDF_OBJECT_ATTRIBUTES 結構的指標，其中包含新組態對象的驅動程式提供屬性。 這個參數是選擇性的，而且可以WDF_NO_OBJECT_ATTRIBUTES。
[_Out_] SubConfiguration
接收新子組態物件句柄之位置的指標。
傳回值
如果作業成功，函式會傳回STATUS_SUCCESS。 否則，此函式可能會傳回適當的NTSTATUS錯誤碼。
備註
如果用戶端提供WDF_OBJECT_ATTRIBUTES，它會為 ParentObject 指定 NULL。 根據預設，子組態會父代至現有的配接器組態物件。
用戶端驅動程式會使用子組態物件或父配接器組態物件呼叫 NetConfigurationClose 來關閉子組態。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最低 KMDF 版本 | 1.21 |
| 最低UMDF版本 | 2.33 |
| 標頭 | netconfiguration.h (包含 netadaptercx.h) |
| 程式庫 | NetAdapterCxStub.lib |
| IRQL | PASSIVE_LEVEL |