Compartilhar via


Função NdisIMGetBindingContext (ndis.h)

A função NdisIMGetBindingContext permite que um driver de protocolo NDIS acesse a área de contexto do dispositivo, que foi criada por um driver intermediário subjacente, para um miniporto virtual ao qual o driver de protocolo de nível mais alto está associado.

Sintaxe

NDIS_HANDLE NdisIMGetBindingContext(
  [in] NDIS_HANDLE NdisBindingHandle
);

Parâmetros

[in] NdisBindingHandle

O identificador de associação que a função NdisOpenAdapterEx retornou no parâmetro NdisBindingHandle que identifica o miniporto virtual do próximo driver intermediário inferior ao qual o chamador está associado.

Retornar valor

NdisIMGetBindingContext retorna um identificador para a área de contexto do dispositivo para o miniporto virtual fornecido ou retorna NULL se essa área de contexto não existir.

Comentários

Um driver de protocolo ou driver intermediário pode chamar NdisIMGetBindingContext de sua função ProtocolBindAdapterEx para acessar o contexto do dispositivo para um miniporto virtual ao qual ele está associado. O contexto do dispositivo fornece uma área de contexto comum para todos os drivers de protocolo que estão associados ao mesmo driver intermediário subjacente.

Essa área de contexto do dispositivo foi alocada e definida pelo driver intermediário NDIS de nível inferior e passada para o NDIS em uma chamada para o Função NdisIMInitializeDeviceInstanceEx .

Todos os drivers de protocolo que chamam NdisIMGetBindingContext podem assumir com segurança que o driver intermediário subjacente alocou sua área de contexto do pool nãopagado. Eles devem tratar a área de contexto retornada como somente leitura, preservando o estado configurado pelo driver intermediário do NDIS subjacente que a definiu.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisIMGetBindingContext (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisIMGetBindingContext (NDIS 5.1)) no Windows XP.
Plataforma de Destino Área de Trabalho
Cabeçalho ndis.h (inclua Ndis.h)
Biblioteca Ndis.lib
IRQL < DISPATCH_LEVEL
Regras de conformidade da DDI Irql_IM_Function(ndis)

Confira também

NdisIMInitializeDeviceInstanceEx

NdisOpenAdapterEx

ProtocolBindAdapterEx