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.
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