Funzione NdisFGetOptionalSwitchHandlers (ndis.h)
Le estensioni del commutatore estendibile Hyper-V 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 di opzione 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 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 Funzioni del gestore del commutatore estendibile Hyper-V.
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 commutatore estendibile sottostante.
Commenti
L'estensione chiama la funzione NdisFGetOptionalSwitchHandlers dalla relativa funzione FilterAttach .
Se l'estensione è installata con più voci INF FilterMediaTypes , 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 sulle voci INF FilterMediaTypes per le estensioni del commutatore estendibile, vedere Requisiti INF per le estensioni del commutatore estendibile Hyper-V.
Requisiti
| 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 |
Vedi anche