EVT_MBB_DEVICE_CREATE_ADAPTER função de retorno de chamada (mbbcx.h)
A função de retorno de chamada EvtMbbDeviceCreateAdapter é implementada pelo driver cliente para criar um objeto NETADAPTER para uma sessão de dados.
Sintaxe
EVT_MBB_DEVICE_CREATE_ADAPTER EvtMbbDeviceCreateAdapter;
NTSTATUS EvtMbbDeviceCreateAdapter(
WDFDEVICE Device,
NETADAPTER_INIT *AdapterInit
)
{...}
Parâmetros
Device
Um identificador para um objeto de dispositivo de estrutura que o driver cliente obteve de uma chamada anterior para WdfDeviceCreate.
AdapterInit
Um objeto NETADAPTER_INIT que descreve as informações de inicialização do NETADAPTER.
Retornar valor
Essa função de retorno de chamada retornará STATUS_SUCCESS se a operação tiver sido bem-sucedida. Caso contrário, ele retornará um código de erro NTSTATUS apropriado.
Comentários
Um driver cliente MBBCx deve registrar uma função de retorno de chamada EvtMbbDeviceCreateAdapter chamando MbbDeviceInitialize.
Nesse retorno de chamada, o driver do cliente cria um objeto NETADAPTER que é usado pelo MBBCx para representar o adaptador de rede de uma sessão de dados. O MBBCx invoca essa função de retorno de chamada pelo menos uma vez para estabelecer o portador EPS de contexto PDP primário/padrão e, em seguida, ele pode invocá-la mais vezes, uma vez para que cada sessão de dados seja estabelecida.
Antes de retornar de EvtMbbDeviceCreateAdapter, os drivers de cliente devem iniciar o adaptador chamando NetAdapterStart. Opcionalmente, eles também podem definir os recursos do adaptador chamando uma ou mais dessas funções antes da chamada para NetAdapterStart:
Para obter mais informações e um exemplo de código, consulte Criando a interface NetAdapter para o portador de contexto PDP/EPS.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10, versão 1903 |
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.29 |
| Cabeçalho | mbbcx.h |
| IRQL | PASSIVE_LEVEL |