Função NdisIMGetDeviceContext (ndis.h)
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 |