Partilhar via

Função NdisIMGetDeviceContext (ndis.h)

  • Artigo

Observação 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 o NDIS 6. x, consulte portabilidade de drivers NDIS 5.x para NDIS 6.0.

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

Sintaxe

NDIS_HANDLE NdisIMGetDeviceContext(
  [in] NDIS_HANDLE MiniportAdapterHandle
);

Parâmetros

[in] MiniportAdapterHandle

Especifica a entrada do identificador para MiniportInitialize.

Valor de retorno

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.
ZERO Se a função ProtocolBindAdapter do driver não alocasse essa área de contexto do dispositivo.

Observações

Uma função MiniportInitialize de driver intermediário do 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 é necessário para 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 ainda de nível superior que se associam posteriormente à NIC virtual.

Os protocolos NDIS de nível ainda mais alto associados à mesma NIC virtual posteriormente podem acessar essa área de contexto do dispositivo chamando NdisIMGetBindingContext de suas funções de 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

Consulte também