NdisIMGetDeviceContext

9/8/2008

Essa função permite que um intermediário NDIS do driver MiniportInitialize função para acessar a área contexto dispositivo alocada pelo seu ProtocolBindAdapter função.

Syntax

NDIS_HANDLE NdisIMGetDeviceContext(
  NDIS_HANDLE MiniportAdapterHandle
);

Parameters

• MiniportAdapterHandle
  [no] Especifica a entrada identificador para MiniportInitialize.

Return Value

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

Valor	Descrição
NDISIMGETDEVICECONTEXT	Retorna acessar a área contexto de dispositivo para o NIC virtual identificado por MiniportAdapterHandle.
NULL	Se função ProtocolBindAdapter do driver não alocar tal uma área contexto dispositivo.

Remarks

Um intermediário NDIS do driver MiniportInitialize função chamadas NdisIMGetDeviceContext Para acessar a área contexto dispositivo para o NIC virtual ele está inicializando. Normalmente, a memória para tal uma área é fornecida pelo intermediário do driver ProtocolBindAdapter função, que chama NdisIMInitializeDeviceInstanceEx Com um ponteiro para esta área, causando, assim, do o driver MiniportInitialize função seja chamado. No entanto, um intermediário driver não é exigido para que tal uma área contexto.

No retorno de NdisIMGetDeviceContext, MiniportInitialize Configura o estado driver-defined para o NIC virtuais com qualquer informações o intermediário gravador driver pretende ser útil de nível mais alto para ainda protocolos que BIND próprios subseqüentemente para seu NIC virtual.

Nível ainda maior NDIS protocolos ligado para a mesma NIC virtual posteriormente pode acessar esta área contexto dispositivo por chamado NdisIMGetBindingContext do seu ProtocolBindAdapter funções.

Requirements

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

See Also

Reference

MiniportInitialize
NdisIMGetBindingContext
NdisIMInitializeDeviceInstanceEx
ProtocolBindAdapter