Função NetAdapterInitAllocate (netadapter.h)
A função NetAdapterInitAllocate aloca uma estrutura NETADAPTER_INIT que um driver cliente usa ao criar um novo objeto NETADAPTER.
Sintaxe
NETADAPTER_INIT * NetAdapterInitAllocate(
[_In_] WDFDEVICE Device
);
Parâmetros
[_In_] Device
Um identificador para um objeto de dispositivo de estrutura.
Retornar valor
Retorna um ponteiro para uma estrutura de NETADAPTER_INIT alocada por estrutura se a operação for bem-sucedida. Caso contrário, essa função retornará NULL.
Importante
Se um driver de cliente receber uma estrutura NETADAPTER_INIT de uma chamada bem-sucedida para essa função, o driver sempre deverá chamar NetAdapterInitFree para desalocá-la, independentemente do resultado de NetAdapterCreate.
Comentários
Um driver de cliente chama NetAdapterInitAllocate para obter uma estrutura NETADAPTER_INIT que ele pode passar para NetAdapterCreate.
Depois que NetAdapterInitAllocate for bem-sucedido, os drivers de cliente poderão, opcionalmente, chamar as funções NetAdapterInitSetXxx para definir outros atributos de inicialização para o NETADAPTER.
Para obter um exemplo de código de criação de um NETADAPTER, consulte Inicialização do dispositivo.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.27 |
| Versão mínima do UMDF | 2.33 |
| Cabeçalho | netadapter.h (inclua netadaptercx.h) |
| Biblioteca | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |