Función NetAdapterInitAllocate (netadapter.h)
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 |
Versión mínima de UMDF | 2,33 |
Encabezado | netadapter.h (include netadaptercx.h) |
Library | netadaptercxstub.lib |
IRQL | PASSIVE_LEVEL |