Función NetDeviceOpenConfiguration (netdevice.h)
La función NetDeviceOpenConfiguration abre la base de datos de configuración de un dispositivo net.
Sintaxis
NTSTATUS NetDeviceOpenConfiguration(
[_In_] WDFDEVICE Device,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
[_Out_] NETCONFIGURATION *Configuration
);
Parámetros
[_In_] Device
Objeto WDFDEVICE que el controlador de cliente creó anteriormente con una llamada a WdfDeviceCreate.
[_In_opt_] ConfigurationAttributes
Puntero a una estructura WDF_OBJECT_ATTRIBUTES que contiene atributos proporcionados por el controlador para el nuevo objeto de configuración. Este parámetro es opcional y puede ser WDF_NO_OBJECT_ATTRIBUTES.
[_Out_] Configuration
Puntero a la ubicación que recibe el nuevo objeto NETCONFIGURATION.
Valor devuelto
Esta función devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta función puede devolver un código de error NTSTATUS adecuado.
Comentarios
Normalmente, el cliente llama a esta función desde su EVT_WDF_DRIVER_DEVICE_ADD función de devolución de llamada.
Si el cliente proporciona un WDF_OBJECT_ATTRIBUTES, especifica NULL para ParentObject. El objeto de configuración del dispositivo se primaria automáticamente en el objeto de dispositivo.
Como resultado, WDF elimina automáticamente el objeto de configuración cuando se elimina el dispositivo. Sin embargo, el cliente puede eliminar manualmente un objeto de configuración mediante una llamada a WdfObjectDelete, normalmente desde su función de devolución de llamada EVT_WDF_OBJECT_CONTEXT_CLEANUP .
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.27 |
| Versión mínima de UMDF | 2,33 |
| Encabezado | netdevice.h (include netadaptercx.h) |
| Library | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |