NetAdapterOpenConfiguration - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// netadapter.h
NTSTATUS NetAdapterOpenConfiguration(
[_In_] NETADAPTER Adapter,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
[_Out_] NETCONFIGURATION *Configuration
);
View the official Windows Driver Kit DDI referenceNo description available.
The NetAdapterOpenConfiguration function opens a net adapter’s configuration database.
Adapter [_In_]The network adapter object that the client created in a prior call to NetAdapterCreate.
ConfigurationAttributes [_In_opt_]A pointer to a WDF_OBJECT_ATTRIBUTES structure that contains driver-supplied attributes for the new configuration object. This parameter is optional and can be WDF_NO_OBJECT_ATTRIBUTES.
Configuration [_Out_]A pointer to a location that receives a handle to the new adapter configuration object.
The function returns STATUS_SUCCESS if the operation succeeds. Otherwise, this function may return an appropriate NTSTATUS error code.
Typically, the client calls this function from its EVT_WDF_DRIVER_DEVICE_ADD callback function.
If the client provides a WDF_OBJECT_ATTRIBUTES, it specifies NULL for ParentObject. The adapter configuration object is automatically parented to the adapter object.
As a result, WDF automatically deletes the configuration object when the adapter is deleted. However, the client can manually delete a configuration object by calling WdfObjectDelete, typically from its EVT_WDF_OBJECT_CONTEXT_CLEANUP callback function.
Accessing configuration information