Função NdisFGetOptionalSwitchHandlers (ndis.h)

As extensões de comutador extensível do Hyper-V chamam a função NdisFGetOptionalSwitchHandlers para obter uma lista de ponteiros para as funções do manipulador de comutador extensível do Hyper-V.

Sintaxe

NDIS_STATUS NdisFGetOptionalSwitchHandlers(
  [in]      NDIS_HANDLE                    NdisFilterHandle,
  [out]     PNDIS_SWITCH_CONTEXT           NdisSwitchContext,
  [in, out] PNDIS_SWITCH_OPTIONAL_HANDLERS NdisSwitchHandlers
);

Parâmetros

[in] NdisFilterHandle

O identificador NDIS que identifica esse módulo de filtro. Quando o NDIS chamou a função FilterAttach da extensão, ele passou esse identificador no parâmetro NdisFilterHandle .

[out] NdisSwitchContext

Um ponteiro para o valor NDIS_SWITCH_CONTEXT que identifica o módulo de comutador extensível ao qual a extensão está anexada. Quando a extensão chama uma função de manipulador de comutador extensível, ela deve definir o parâmetro NdisSwitchContext como o valor desse identificador.

[in, out] NdisSwitchHandlers

Um ponteiro para uma estrutura de NDIS_SWITCH_OPTIONAL_HANDLERS alocada pelo chamador. Se a chamada for bem-sucedida, essa estrutura conterá uma lista de ponteiros para as funções extensíveis do manipulador de comutador.

Para obter mais informações sobre essas funções de manipulador, consulte Funções de manipulador de comutador extensível do Hyper-V.

Nota Antes que a extensão chame NdisFGetOptionalSwitchHandlers, ela deve inicializar o membro Header da estrutura NDIS_SWITCH_OPTIONAL_HANDLERS .
 

Retornar valor

Se a chamada for bem-sucedida, NdisFGetOptionalSwitchHandlers retornará NDIS_STATUS_SUCCESS. Caso contrário, ele retornará NDIS_STATUS_NOT_SUPPORTED se a extensão de comutador extensível não estiver associada ao componente de comutador extensível subjacente.

Comentários

A extensão chama a função NdisFGetOptionalSwitchHandlers de sua função FilterAttach .

Se a extensão estiver instalada com várias entradas INF FilterMediaTypes , a chamada para NdisFGetOptionalSwitchHandlers permitirá que a extensão determine se ela está associada e anexada à pilha de driver para o comutador extensível ou um adaptador de rede física. Se a chamada retornar NDIS_STATUS_SUCCESS, a extensão será anexada na pilha de driver de comutador extensível. Se a chamada retornar NDIS_STATUS_NOT_SUPPORTED, a extensão será anexada na pilha do driver para um adaptador de rede física.

Para obter mais informações sobre entradas INF FilterMediaTypes para extensões de comutador extensíveis, consulte Requisitos inf para extensões de comutador extensível do Hyper-V.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte no NDIS 6.30 e posterior.
Plataforma de Destino Universal
Cabeçalho ndis.h (inclua Ndis.h)
Biblioteca Ndis.lib
IRQL <= DISPATCH_LEVEL

Confira também

FilterAttach

NDIS_SWITCH_OPTIONAL_HANDLERS