NetAdapterOpenConfiguration 函式 (netadapter.h)
NetAdapterOpenConfiguration 函式會開啟網路適配器的組態資料庫。
語法
NTSTATUS NetAdapterOpenConfiguration(
[_In_] NETADAPTER Adapter,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
[_Out_] NETCONFIGURATION *Configuration
);
參數
[_In_] Adapter
用戶端在呼叫 NetAdapterCreate 之前建立的網路適配器物件。
[_In_opt_] ConfigurationAttributes
包含新組態物件之驅動程式提供屬性 之WDF_OBJECT_ATTRIBUTES 結構的指標。 此參數是選擇性的，而且可以WDF_NO_OBJECT_ATTRIBUTES。
[_Out_] Configuration
接收新配接器組態物件句柄的位置指標。
傳回值
如果作業成功，函式會傳回STATUS_SUCCESS。 否則，此函式可能會傳回適當的NTSTATUS錯誤碼。
備註
一般而言，用戶端會從其 EVT_WDF_DRIVER_DEVICE_ADD 回呼函式呼叫此函式。
如果用戶端提供WDF_OBJECT_ATTRIBUTES，它會指定 ParentObject 的 NULL。 配接器組態物件會自動父代至配接器物件。
因此，WDF 會在刪除配接器時自動刪除組態物件。 不過，用戶端可以藉由呼叫 WdfObjectDelete 手動刪除設定物件，通常是從其 EVT_WDF_OBJECT_CONTEXT_CLEANUP 回呼函式。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最小 KMDF 版本 | 1.21 |
| 最低UMDF版本 | 2.33 |
| 標頭 | netadapter.h (包括 netadaptercx.h) |
| 程式庫 | NetAdapterCxStub.lib |
| IRQL | PASSIVE_LEVEL |