Función NetAdapterCreate (netadapter.h)

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ó previamente de una llamada a NetAdapterInitAllocate.

[_In_opt_] AdapterAttributes

Puntero a una estructura de WDF_OBJECT_ATTRIBUTES asignada por el autor de la llamada. El ParentObject de de la estructura debe ser NULL. El parámetro es opcional y puede ser 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.

Observaciones

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 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	Valor
de la plataforma de destino de	Universal
versión mínima de KMDF	1.27
versión mínima de UMDF	2.33
encabezado de	netadapter.h (include netadaptercx.h)
biblioteca de	NetAdapterCxStub.lib
irQL	PASSIVE_LEVEL