Share via

Função NdisIMGetDeviceContext (ndis.h)

  • Artigo

Nota NDIS 5. x foi preterido e substituído pelo NDIS 6. x. Para obter um novo desenvolvimento de driver NDIS, consulte Drivers de rede começando com o Windows Vista. Para obter informações sobre como portar o NDIS 5. x drivers para NDIS 6. x, consulte Portabilidade de drivers NDIS 5.x para NDIS 6.0.

Essa função permite que a função MiniportInitialize de um driver intermediário NDIS acesse a área de contexto do dispositivo alocada por sua função ProtocolBindAdapter .

Sintaxe

NDIS_HANDLE NdisIMGetDeviceContext(
  [in] NDIS_HANDLE MiniportAdapterHandle
);

Parâmetros

[in] MiniportAdapterHandle

Especifica a entrada do identificador para MiniportInitialize.

Retornar valor

A tabela a seguir mostra os valores retornados para essa função.

Valor Descrição
NDISIMGETDEVICECONTEXT Retorna acesso à área de contexto do dispositivo para a NIC virtual identificada por MiniportAdapterHandle.
NULO Se a função ProtocolBindAdapter do driver não alocou essa área de contexto do dispositivo.

Comentários

Uma função MiniportInitialize do driver intermediário NDIS chama NdisIMGetDeviceContext para acessar a área de contexto do dispositivo para a NIC virtual que está inicializando. Normalmente, a memória para essa área é fornecida pela função ProtocolBindAdapter do driver intermediário, que chama NdisIMInitializeDeviceInstanceEx com um ponteiro para essa área, fazendo com que a função MiniportInitialize do driver seja chamada. No entanto, um driver intermediário não precisa ter essa área de contexto.

No retorno de NdisIMGetDeviceContext, MiniportInitialize configura o estado definido pelo driver para a NIC virtual com qualquer informação que o gravador de driver intermediário pretende ser útil para protocolos de nível ainda mais alto que se associam posteriormente à NIC virtual.

Os protocolos NDIS de nível ainda mais alto associados à mesma NIC virtual subsequentemente podem acessar essa área de contexto do dispositivo chamando NdisIMGetBindingContext de suas funções ProtocolBindAdapter .

Versões do sistema operacional: Windows CE .NET 4.0 e posterior.

Requisitos

Requisito Valor
Cabeçalho ndis.h
Biblioteca Ndis.lib
IRQL IRQL <= DISPATCH_LEVEL

Confira também