Função NdisFGetOptionalSwitchHandlers (ndis.h)
Hyper-V extensíveis de comutador chamam a função NdisFGetOptionalSwitchHandlers para obter uma lista de ponteiros para as funções do manipulador de comutador extensível 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, ela 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 para 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 Hyper-V Extensible Switch Handler Functions.
Valor de retorno
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.
Observações
A extensão chama a função NdisFGetOptionalSwitchHandlers de sua função FilterAttach.
Se a extensão estiver instalada com várias entradas FilterMediaTypes INF, 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ísico.
Para obter mais informações sobre FilterMediaTypes entradas INF para extensões de comutador extensível, consulte Requisitos inf para Hyper-V extensíveis de extensões de comutador.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte no NDIS 6.30 e posterior. |
| da Plataforma de Destino | Universal |
| cabeçalho | ndis.h (inclua Ndis.h) |
| biblioteca | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
Consulte também