OID_SWITCH_PORT_PROPERTY_ENUM

Articolo
06/15/2023

L'estensione del commutatore estendibile Hyper-V genera una richiesta del metodo OID (Object Identifier) di OID_SWITCH_PORT_PROPERTY_ENUM per ottenere una matrice. Questa matrice contiene i criteri di porta di cui è stato effettuato il provisioning che soddisfano i criteri specificati. Ogni elemento nella matrice specifica le proprietà di un criterio per una porta del commutatore estendibile specificata.

Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a un buffer. Questo buffer contiene i dati seguenti:

Struttura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS che specifica i parametri per l'enumerazione dei criteri di una porta specificata.
Matrice di strutture NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO . Ognuna di queste strutture contiene informazioni sulle proprietà di un criterio di porta commutatore estendibile.

Nota Se il membro NumProperties della struttura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS è impostato su zero, non vengono restituite strutture NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO .

Commenti

Prima di eseguire una richiesta di metodo OID di OID_SWITCH_PORT_PROPERTY_ENUM, l'estensione del commutatore estendibile deve seguire queste linee guida:

L'estensione può inviare la richiesta di OID_SWITCH_PORT_PROPERTY_ENUM solo dopo che il bordo del protocollo dell'commutatore estendibile genera una richiesta di OID_SWITCH_PORT_CREATE e prima che esegui una richiesta di OID_SWITCH_PORT_TEARDOWN .
L'estensione deve chiamare ReferenceSwitchPort prima di chiamare NdisFOidRequest per emettere la richiesta di OID_SWITCH_PORT_PROPERTY_ENUM. In questo modo si garantisce che la porta specificata non venga eliminata fino al completamento della richiesta OID.

Al termine della richiesta OID, l'estensione deve chiamare DereferenceSwitchPort. L'estensione deve chiamare questa funzione indipendentemente dal fatto che la richiesta OID sia stata completata con NDIS_STATUS_SUCCESS.

L'OID OID_SWITCH_PORT_PROPERTY_ENUM deve essere generato solo quando l'opzione estendibile Hyper-V ha completato l'attivazione. Per altre informazioni, vedere Esecuzione di query sulla configurazione del commutatore estendibile Hyper-V .

Nota Se l'estensione riceve la richiesta del metodo OID di OID_SWITCH_PORT_PROPERTY_ENUM, non deve completare la richiesta OID. Deve invece chiamare NdisFOidRequest per inoltrare la richiesta OID nello stack di driver del commutatore estendibile.

Codici di stato restituiti

Il bordo miniport sottostante dell'opzione estendibile completa la richiesta di query OID di OID_SWITCH_PORT_PROPERTY_ENUM e restituisce il codice di stato seguente.