共用方式為


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,它會指定 ParentObjectNULL。 裝置組態物件會自動父代至裝置物件。

因此,WDF 會在刪除裝置時自動刪除組態物件。 不過,用戶端可以藉由呼叫 WdfObjectDelete呼叫來手動刪除設定物件,通常是從其 EVT_WDF_OBJECT_CONTEXT_CLEANUP 回呼函式。

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.27
最低 UMDF 版本 2.33
標頭 netdevice.h (包括 netadaptercx.h)
連結庫 netadaptercxstub.lib
IRQL PASSIVE_LEVEL

另請參閱

存取組態資訊