EVT_MBB_DEVICE_CREATE_ADAPTER função de retorno de chamada (mbbcx.h)

  • Artigo

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