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