Función NetAdapterCreate (netadapter.h)

  • Artículo

Crea un objeto NETADAPTER.

Sintaxis

NTSTATUS NetAdapterCreate(
  [_In_]     NETADAPTER_INIT       *AdapterInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *AdapterAttributes,
  [_Out_]    NETADAPTER            *Adapter
);

Parámetros

[_In_] AdapterInit

Puntero a una estructura de NETADAPTER_INIT que el controlador cliente recibió anteriormente de una llamada a NetAdapterInitAllocate.

[_In_opt_] AdapterAttributes

Puntero a una estructura de WDF_OBJECT_ATTRIBUTES asignada por el autor de la llamada. El objeto ParentObject de la estructura debe ser NULL. El parámetro es opcional y se puede WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] Adapter

Puntero a una ubicación que recibe un identificador para el nuevo objeto NETADAPTER.

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

Después de llamar a WdfDeviceCreate, el cliente normalmente llama a NetAdapterCreate desde su rutina EvtDriverDeviceAdd .

Para obtener un ejemplo de código de creación de un NETADAPTER, consulte Inicialización de dispositivos.

El objeto NETADAPTER es un objeto WDF estándar. El marco administra su eliminación, que se produce cuando se elimina el WDFDEVICE primario.

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.27
Encabezado netadapter.h (include netadaptercx.h)
Library NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL