Función NetAdapterOpenConfiguration (netadapter.h)
La función NetAdapterOpenConfiguration abre la base de datos de configuración de un adaptador de red.
Sintaxis
NTSTATUS NetAdapterOpenConfiguration(
[_In_] NETADAPTER Adapter,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
[_Out_] NETCONFIGURATION *Configuration
);
Parámetros
[_In_] Adapter
Objeto de adaptador de red que el cliente creó en una llamada anterior a NetAdapterCreate.
[_In_opt_] ConfigurationAttributes
Puntero a una estructura de WDF_OBJECT_ATTRIBUTES que contiene atributos proporcionados por el controlador para el nuevo objeto de configuración. Este parámetro es opcional y se puede WDF_NO_OBJECT_ATTRIBUTES.
[_Out_] Configuration
Puntero a una ubicación que recibe un identificador para el nuevo objeto de configuración del adaptador.
Valor devuelto
La 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 adaptador se inserta automáticamente en el objeto de adaptador.
Como resultado, WDF elimina automáticamente el objeto de configuración cuando se elimina el adaptador. Sin embargo, el cliente puede eliminar manualmente un objeto de configuración llamando 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.21 |
Versión mínima de UMDF | 2,33 |
Encabezado | netadapter.h (include netadaptercx.h) |
Library | NetAdapterCxStub.lib |
IRQL | PASSIVE_LEVEL |
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de