Funzione NdisFGetOptionalSwitchHandlers (ndis.h)
Hyper-V estensioni del commutatore estendibile chiamano la funzione NdisFGetOptionalSwitchHandlers per ottenere un elenco di puntatori alle funzioni del gestore del commutatore estendibile Hyper-V.
Sintassi
NDIS_STATUS NdisFGetOptionalSwitchHandlers(
[in] NDIS_HANDLE NdisFilterHandle,
[out] PNDIS_SWITCH_CONTEXT NdisSwitchContext,
[in, out] PNDIS_SWITCH_OPTIONAL_HANDLERS NdisSwitchHandlers
);
Parametri
[in] NdisFilterHandle
Handle NDIS che identifica questo modulo di filtro. Quando NDIS ha chiamato la funzione FilterAttach dell'estensione, ha passato questo handle nel parametro NdisFilterHandle.
[out] NdisSwitchContext
Puntatore al valore NDIS_SWITCH_CONTEXT che identifica il modulo switch estendibile a cui è collegata l'estensione. Quando l'estensione chiama una funzione del gestore switch estendibile, deve impostare il parametro NdisSwitchContext sul valore di questo handle.
[in, out] NdisSwitchHandlers
Puntatore a una struttura di NDIS_SWITCH_OPTIONAL_HANDLERS allocata dal chiamante. Se la chiamata ha esito positivo, questa struttura conterrà un elenco di puntatori alle funzioni del gestore del commutatore estendibile.
Per altre informazioni su queste funzioni del gestore, vedere Hyper-V Extensible Switch Handler Functions.
Valore restituito
Se la chiamata ha esito positivo, NdisFGetOptionalSwitchHandlers restituisce NDIS_STATUS_SUCCESS. In caso contrario, restituisce NDIS_STATUS_NOT_SUPPORTED se l'estensione del commutatore estendibile non è associata al componente switch estendibile sottostante.
Osservazioni
L'estensione chiama la funzione NdisFGetOptionalSwitchHandlers dalla relativa funzione FilterAttach.
Se l'estensione viene installata con più FilterMediaTypes voci INF, la chiamata a NdisFGetOptionalSwitchHandlers consente all'estensione di determinare se è associata e collegata allo stack di driver per il commutatore estendibile o una scheda di rete fisica. Se la chiamata restituisce NDIS_STATUS_SUCCESS, l'estensione viene collegata all'interno dello stack di driver del commutatore estendibile. Se la chiamata restituisce NDIS_STATUS_NOT_SUPPORTED, l'estensione viene collegata all'interno dello stack di driver per una scheda di rete fisica.
Per altre informazioni su FilterMediaTypes voci INF per le estensioni di commutatori estendibili, vedere requisiti INF per Hyper-V extensible switch extensions.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Supportato in NDIS 6.30 e versioni successive. |
| piattaforma di destinazione | Universale |
| intestazione | ndis.h (include Ndis.h) |
| libreria | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
Vedere anche