Compartilhar via

Função NdisGetRoutineAddress (ndis.h)

  • Artigo

A função NdisGetRoutineAddress retorna o endereço de uma rotina dado o nome da rotina.

Sintaxe

PVOID NdisGetRoutineAddress(
  [in] PNDIS_STRING NdisRoutineName
);

Parâmetros

[in] NdisRoutineName

Um ponteiro para uma estrutura UNICODE_STRING que especifica a cadeia de caracteres que contém o nome de uma rotina.

Retornar valor

Retorna o endereço da rotina cujo nome é especificado em NdisRoutineName se a rotina estiver disponível; caso contrário, NULL.

Comentários

Um driver NDIS pode usar NdisGetRoutineAddress para obter o endereço de uma rotina de NDIS exportada. Em seguida, o driver pode usar esse endereço para chamar a rotina NDIS.

Um driver NDIS poderá usar NdisGetRoutineAddress se o driver precisar permanecer compatível com versões anteriores. Por exemplo, se esse driver importar uma rotina NDIS que não é exportada pela versão do NDIS que está em execução no momento, o gerenciador de E/S não carregará o driver no sistema operacional. No entanto, o driver pode primeiro usar NdisGetRoutineAddress para determinar se a rotina está disponível na versão do NDIS que está em execução no momento. Se disponível, o endereço da rotina será retornado. Em seguida, o driver pode usar o endereço para chamar a rotina. Se não estiver disponível, NULL será retornado. O driver não pode chamar a rotina, mas o driver ainda carrega no sistema operacional.

Nenhuma melhoria de desempenho é obtida usando o endereço retornado por NdisGetRoutineAddress em vez de chamar a rotina especificada pelo nome. Portanto, não escreva um driver NDIS para usar NdisGetRoutineAddress se você souber que a versão do NDIS com a qual o driver executará exporta a rotina especificada.

Normalmente, um driver NDIS chama NdisGetRoutineAddress em sua rotina DriverEntry .

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisGetRoutineAddress (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisGetRoutineAddress (NDIS 5.1)) no Windows XP.
Plataforma de Destino Universal
Cabeçalho ndis.h (inclua Ndis.h)
Biblioteca Ndis.lib
IRQL PASSIVE_LEVEL
Regras de conformidade da DDI Irql_Miscellaneous_Function(ndis)

Confira também

DriverEntry

UNICODE_STRING