Função NetDmaGetVersion (netdma.h)

  • Artigo
Nota Não há suporte para a interface NetDMA

em Windows 8 e posterior.

 

A função NetDmaGetVersion retorna a versão da interface NetDMA à qual o computador local dá suporte.

Sintaxe

NET_DMA_EXPORT UINT NetDmaGetVersion();

Retornar valor

NetDmaGetVersion retorna um valor UINT que contém os números de versão principal e secundária da seguinte maneira:

Código de retorno Descrição
16 bits altos
 O número de versão principal da interface NetDMA.
16 bits baixos
 A versão secundária da interface NetDMA.

Comentários

Os drivers do provedor NetDMA podem chamar a função NetDmaGetVersion para obter a versão da interface NetDMA. Um provedor NetDMA deve registrar-se como um provedor NetDMA com uma versão igual ou inferior à versão da interface do provedor NetDMA compatível com o computador local. O driver do provedor NetDMA especifica a versão principal e secundária do provedor NetDMA nos membros MajorVersion e MinorVersion do NET_DMA_PROVIDER_CHARACTERISTICS estrutura que passa para o Função NetDmaRegisterProvider .

ObservaçãoNetDmaGetVersion não está disponível no NetDMA versão 1.0. Para evitar o uso de uma importação de função que possa impedir o carregamento do driver, um driver de provedor NetDMA 1.1 ou posterior deve verificar a presença de NetDmaGetVersion antes de chamar NetDmaGetVersion. Para chamar NetDmaGetVersion, primeiro chame a função NdisGetRoutineAddress para obter o ponto de entrada e, em seguida, se NetDmaGetVersion estiver disponível, chame NetDmaGetVersion no ponto de entrada que NdisGetRoutineAddress forneceu. Se o driver do provedor não puder obter o endereço de NetDmaGetVersion, a interface NetDMA com suporte deverá ser a versão 1.0.
 
Os drivers do provedor NetDMA chamam NetDmaGetVersion em IRQL = PASSIVE_LEVEL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte para drivers NetDMA 2.0 e NetDMA 1.1 no Windows Server 2008.
Plataforma de Destino Universal
Cabeçalho netdma.h (inclua Netdma.h)
IRQL PASSIVE_LEVEL

Confira também

NET_DMA_PROVIDER_CHARACTERISTICS

NdisGetRoutineAddress

NetDmaRegisterProvider