Compartilhar via

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.

Valor de retorno

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.

Observações

Um driver cliente MBBCx deve registrar uma função de retorno de chamada EvtMbbDeviceCreateAdapter chamando MbbDeviceInitialize.

Nesse retorno de chamada, o driver cliente cria um objeto NETADAPTER que é usado pelo MBBCx para representar o adaptador de rede para uma sessão de dados. O MBBCx invoca essa função de retorno de chamada pelo menos uma vez para estabelecer o contexto PDP primário/portador EPS padrão e, em seguida, pode invocá-la mais vezes, uma vez para que cada sessão de dados seja estabelecida.

Antes de retornar de EvtMbbDeviceCreateAdapter, os drivers 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 de a chamada para NetAdapterStart:

Para obter mais informações e um exemplo de código, consulte Criando a interface NetAdapter para odo portador PDP/EPS.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 10, versão 1903
da Plataforma de Destino Universal
versão mínima do KMDF 1.29
cabeçalho mbbcx.h
IRQL PASSIVE_LEVEL