Función NetAdapterInitAllocate (netadapter.h)

  • Artículo

La función NetAdapterInitAllocate asigna una estructura de NETADAPTER_INIT que usa un controlador de cliente al crear un nuevo objeto NETADAPTER.

Sintaxis

NETADAPTER_INIT * NetAdapterInitAllocate(
  [_In_] WDFDEVICE Device
);

Parámetros

[_In_] Device

Identificador de un objeto de dispositivo de marco.

Valor devuelto

Devuelve un puntero a una estructura de NETADAPTER_INIT asignada por el marco si la operación se realiza correctamente. De lo contrario, esta función devuelve NULL.

Importante

Si un controlador cliente recibe una estructura de NETADAPTER_INIT de una llamada correcta a esta función, el controlador siempre debe llamar a NetAdapterInitFree para desasignarlo independientemente del resultado de NetAdapterCreate.

Comentarios

Un controlador cliente llama a NetAdapterInitAllocate para obtener una estructura de NETADAPTER_INIT que puede pasar a NetAdapterCreate.

Después de que NetAdapterInitAllocate se realice correctamente, los controladores de cliente pueden llamar opcionalmente a las funciones NetAdapterInitSetXxx para establecer más atributos de inicialización para NETADAPTER.

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

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

Consulte también

Inicialización del dispositivo

NetAdapterCreate

NetAdapterInitFree