OID_SWITCH_PORT_CREATE

Articolo
06/15/2023

Il bordo del protocollo del commutatore estendibile Hyper-V invia una richiesta di set di identificatori di oggetto (OID) di OID_SWITCH_PORT_CREATE per notificare alle estensioni del commutatore estendibile la creazione di una porta commutatore estendibile.

Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_SWITCH_PORT_PARAMETERS .

Commenti

Il membro PortId della struttura NDIS_SWITCH_PORT_PARAMETERS specifica la porta per cui viene effettuata la notifica di creazione.

L'estensione del commutatore estendibile deve seguire queste linee guida per la gestione delle richieste del set OID di OID_SWITCH_PORT_CREATE:

L'estensione non deve modificare la struttura NDIS_SWITCH_PORT_PARAMETERS associata alla richiesta OID.
L'estensione può modificare la notifica di creazione restituendo NDIS_STATUS_DATA_NOT_ACCEPTED per la richiesta OID. Ad esempio, se un'estensione non può allocare risorse per applicare i criteri configurati sulla porta, il driver deve modificare la notifica di creazione.

Se l'estensione restituisce altri codici di stato di errore NDIS_STATUS_Xxx , viene anche attivata la notifica di creazione. Tuttavia, la restituzione di codici di stato per scenari transitori, ad esempio la restituzione di NDIS_STATUS_RESOURCES, potrebbe comportare un nuovo tentativo della notifica di creazione.

Se l'estensione non esegue il veto della richiesta OID, deve monitorare lo stato al termine della richiesta. L'estensione deve eseguire questa operazione per determinare se la richiesta OID è stata attivata dalle estensioni sottostanti nel percorso di controllo del commutatore estendibile o dall'interfaccia del commutatore estendibile.

Per altre informazioni sui criteri delle porte, vedere Gestione dei criteri di commutatore estendibile Hyper-V.
Se l'estensione chiama NdisFOidRequest per inoltrare questa richiesta di set OID, l'estensione deve monitorare lo stato di completamento di questa richiesta OID. L'estensione esegue questa operazione per rilevare se le estensioni sottostanti nello stack di driver del commutatore estendibile hanno veto la notifica di creazione della porta.
Dopo che la richiesta OID viene inoltrata e completata correttamente, l'estensione può inviare richieste OID per la porta, ad esempio OID_SWITCH_PORT_PROPERTY_ENUM, fino a quando non viene emessa una richiesta OID di OID_SWITCH_PORT_TEARDOWN . Questa richiesta OID notifica all'estensione che la porta avvierà il processo di eliminazione dal commutatore estendibile.
Le estensioni non possono inoltrare pacchetti alla porta specificata nella struttura NDIS_SWITCH_PORT_PARAMETERS fino a quando non viene eseguita una richiesta di set OID di OID_SWITCH_NIC_CONNECT e viene completata correttamente.

Nota Le estensioni non devono inviare richieste di set OID di OID_SWITCH_PORT_CREATE.

Per altre informazioni sugli stati delle porte del commutatore estendibile e delle connessioni alle schede di rete, vedere Hyper-V Extensible Switch Port and Network Adapter States.For more information about the states of extensible switch ports and network adapter connections, see Hyper-V Extensible Switch Port and Network Adapter States.

Codici di stato restituiti

Se l'estensione completa la richiesta del set OID di OID_SWITCH_PORT_CREATE, restituisce uno dei codici di stato seguenti.

Codice di stato	Descrizione
NDIS_STATUS_DATA_NOT_ACCEPTED	L'estensione ha veto la notifica di creazione.
NDIS_STATUS_RESOURCES	L'estensione ha veto la notifica di creazione a causa di una condizione di risorsa bassa.
NDIS_STATUS_Xxx	L'estensione ha veto la notifica di creazione per altri motivi.

Nota Se l'estensione completa la richiesta del set OID, non deve restituire NDIS_STATUS_SUCCESS.

Se l'estensione non completa la richiesta del set OID di OID_SWITCH_PORT_CREATE, la richiesta viene completata dal bordo miniport sottostante dell'interruttore estendibile. Il bordo miniport sottostante restituisce il codice di stato seguente per questa richiesta di set OID.