Funzione NdisFGetOptionalSwitchHandlers (ndis.h)

  • Articolo

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.

Nota Prima che l'estensione chiami NdisFGetOptionalSwitchHandlers, deve inizializzare il membro Header della struttura NDIS_SWITCH_OPTIONAL_HANDLERS .
 

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

FilterAttach

NDIS_SWITCH_OPTIONAL_HANDLERS