NdisIMGetBindingContext
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