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.
Valor de retorno
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 cliente receber uma estrutura de 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.
Observações
Um driver cliente chama NetAdapterInitAllocate para obter uma estrutura de NETADAPTER_INIT que pode passar para NetAdapterCreate.
Depois que NetAdapterInitAllocate for bem-sucedido, os drivers cliente poderão chamar opcionalmente funções de 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 de inicialização do dispositivo.
Requisitos
| Requisito | Valor |
|---|---|
| da 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 |