Compartilhar via


NdisIMGetBindingContext

Windows Mobile Not SupportedWindows Embedded CE Supported

9/8/2008

Essa função permite que um protocolo NDIS para acessar a área contexto dispositivo, criado por um subjacente intermediário driver, para um NIC virtual ao qual o protocolo de nível superior é ligado.

Syntax

NDIS_HANDLE NdisIMGetBindingContext(
  NDIS_HANDLE NdisBindingHandle
);

Parameters

  • NdisBindingHandle
    [no] Especifica o identificador retornado por NdisOpenAdapter. Esse identificador identifica a NIC do próximo Virtual inferior intermediário driver ao qual o chamador está ligado.

Return Value

A seguinte tabela mostra os valores de retorno para NdisIMGetBindingContext.

Valor Descrição

NDISIMGETBINDINGCONTEXT

Retorna acessar a área contexto de dispositivo para a NIC virtual determinado.

NULL

Retorna NÃO se existir nenhuma área contexto dispositivo para a NIC virtual determinado.

Remarks

Um nível mais alto protocolo driver ou intermediário protocolo NDIS pode chamar NdisIMGetBindingContext do seu ProtocolBindAdapter função para acessar o contexto dispositivo para um NIC virtual ao qual ele está ligado. O contexto dispositivo fornece uma comum área contexto para todos os protocolos de nível mais alto ligado para a mesma subjacente intermediário driver.

Tal uma área contexto dispositivo foi alocada e definida de nível inferior intermediário NDIS driver e passado para NDIS em um chamar para NdisIMInitializeDeviceInstanceEx. Este intermediário do driver MiniportInitialize função chamadas NdisIMGetDeviceContext Para obter acessar esta área contexto dispositivo se ele foi alocado pelo intermediário do driver ProtocolBindAdapter função.

Todos os protocolos que chamar NdisIMGetBindingContext deve tratar a área contexto retornados como Read-Only, preservando o estado configurada pelo subjacente intermediário NDIS driver que definidos-lo.

Requirements

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

See Also

Reference

NdisOpenAdapter
MiniportInitialize
ProtocolBindAdapter
NdisIMInitializeDeviceInstanceEx
NdisIMGetDeviceContext