NdisIMInitializeDeviceInstanceEx

9/8/2008

Essa função chama um intermediário NDIS do driver MiniportInitialize função para inicializar o driver do NIC virtual e, opcionalmente, para configurar informações do estado sobre o driver é NIC virtual para subseqüentemente ligado protocolos.

Syntax

NDIS_STATUS NdisIMInitializeDeviceInstanceEx(
  NDIS_HANDLE DriverHandle,
  PNDIS_STRING DriverInstance,
  NDIS_HANDLE DeviceContext OPTIONAL
);

Parameters

• DriverHandle
  [no] Especifica o identificador retornado por NdisIMRegisterLayeredMiniport.

• DriverInstance
  [no] Aponta para um armazenada em buffer, Caller-initialized contados seqüência de caracteres no sistema-conjunto de caracteres usar como padrão, nomeação a chave Registro no qual o driver armazena informações sobre seu NIC virtual e, possivelmente, informações Binding-specific.

  O intermediário script instalação do driver criado sua chave designado por DeviceInstance in a SYSTEM\CurrentControlSet\Services HKEY_LOCAL_MACHINE\ árvore Registro.

• DeviceContext
  [no] Aponta para memória Caller-supplied para ser configurar com dispositivo driver-defined contexto informações sobre o NIC virtual, qual nível ainda maior protocolos que subseqüentemente BIND próprios para este NIC virtual podem usar. Este parâmetro pode ser NULL se o intermediário driver não possui nenhum tal área contexto dispositivo.

Return Value

A seguinte tabela mostra os valores de retorno para esta função.

Valor	Descrição
NDIS_STATUS_SUCCESS	O intermediário do driver virtual NIC foi inicializado com êxito.
NDIS_STATUS_NOT_ACCEPTED	NdisIMInitializeDeviceInstanceEx falha porque o dispositivo especificado por DriverHandle já foi inicializado.

Remarks

Um intermediário NDIS driver deve chamar NdisIMInitializeDeviceInstanceEx do seu ProtocolBindAdapter função, assim, controlando quando NDIS chama do o driver MiniportInitialize função para configurar NIC virtual. do driver Uma falha ao chamar NdisIMInitializeDeviceInstanceEx Ou NdisIMInitializeDeviceInstance de um intermediário NDIS driver efetivamente impede carregando si com êxito esse driver. Tal um driver não é possível tornar sua NIC virtual operacionais para os protocolos de nível mais alto ainda, a menos que seu MiniportInitialize função executa.

Antes de ele chama NdisIMInitializeDeviceInstanceEx, o intermediário do driver ProtocolBindAdapter função deve fazer um bem-sucedido chamar para NdisOpenAdapter, assim, ligação o intermediário driver como um protocolo para o subjacente miniporta NIC. O ProtocolBindAdapter função pode alocar uma área no DeviceContext Além disso, possivelmente configuração ele Backup com intermediário driver-determined informações sobre os recursos da subjacente NIC, coletadas pelo ProtocolBindAdapter. O intermediário do driver MiniportInitialize função pode usar essas informações posteriormente para configurar essa área contexto com informações sobre NIC virtual. do driver

Após seu bem-sucedido chamar para NdisOpenAdapter, o intermediário chamar subseqüentes do driver para NdisIMInitializeDeviceInstanceEx Faz com que NDIS para chamar o intermediário função MiniportInitialize do driver. MiniportInitialize Aloca os recursos que o driver precisa para realizar operações rede E/S, such as chamado NdisMSetAttributesExe para inicializar o driver do NIC virtual para um estado operacional. Em seguida, protocolos de nível mais alto ainda podem BIND próprios para seu NIC virtual quando o intermediário inicialização do driver é concluída com êxito. O intermediário do driver MiniportInitialize função pode chamar NdisIMGetDeviceContext Para obter acessar para a área no DeviceContext Se tal uma área é fornecida pelo seu ProtocolBindAdapter função.

Após MiniportInitialize Retorna controle, o intermediário área contexto dispositivo do driver, se houver algum, pode conter qualquer intermediário - driver - definido dados que permite subseqüentemente nível mais alto todos os protocolos ligado para a mesma NIC virtual para acessar informações em que área contexto. Tal um protocolo de nível mais alto possível consulta o intermediário - driver - fornecido contexto para dispositivo com NdisIMGetBindingContext.

Requirements

Header	ndis.h
Library	ndis.lib
Windows Embedded CE	Windows CE .NET 4.0 and later

See Also

Reference

MiniportInitialize
NdisAllocateMemory
NdisIMDeInitializeDeviceInstance
NdisIMGetBindingContext
NdisIMGetDeviceContext
NdisIMInitializeDeviceInstance
NdisIMRegisterLayeredMiniport
NdisInitializeString
NdisMSetAttributesEx
NdisOpenAdapter
ProtocolBindAdapter