OID_SWITCH_PORT_PROPERTY_UPDATE

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_PROPERTY_UPDATE per notificare alle estensioni del commutatore estendibile l'aggiornamento di una proprietà per un criterio di porta commutatore estendibile.

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_PARAMETERS che specifica l'identificazione e il tipo di una proprietà di porta.
Buffer delle proprietà che contiene i parametri per un criterio di porta. Il buffer delle proprietà contiene una struttura basata sul membro PropertyType della struttura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS . Ad esempio, se il membro PropertyType è impostato su NdisSwitchPortPropertyTypeVlan, il buffer della proprietà contiene una struttura NDIS_SWITCH_PORT_PROPERTY_VLAN .

Commenti

Un'estensione di inoltro può gestire la richiesta del set OID di OID_SWITCH_PORT_PROPERTY_UPDATE. Tutti gli altri tipi di estensioni devono chiamare NdisFOidRequest per inoltrare la richiesta OID all'estensione successiva nello stack di driver del commutatore estendibile.

L'estensione può modificare la proprietà della porta restituendo NDIS_STATUS_DATA_NOT_ACCEPTED per la richiesta OID. Se, ad esempio, un'estensione non può allocare risorse per applicare i criteri aggiornati sulla porta, deve modificare la richiesta di aggiornamento.

Nota Se l'estensione restituisce altri codici di stato di errore NDIS_STATUS_Xxx , viene anche attivata la notifica di aggiornamento. 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 linee guida su come gestire una richiesta di set OID di OID_SWITCH_PORT_PROPERTY_UPDATE, vedere Gestione dei criteri di porta.

Codici di stato restituiti

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

Codice di stato	Descrizione
NDIS_STATUS_INVALID_LENGTH	La lunghezza del buffer delle informazioni è troppo piccola per elaborare la struttura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS e i dati nel buffer delle proprietà della struttura. L'estensione imposta i dati. SET_INFORMATION. Membro BytesNeeded nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie.
NDIS_STATUS_DATA_NOT_ACCEPTED	L'estensione di inoltro ha veto la notifica di eliminazione dei criteri di porta.
NDIS_STATUS_NOT_SUPPORTED	L'estensione di inoltro non supporta i criteri di porta.
NDIS_STATUS_Xxx	La richiesta OID non è riuscita per altri motivi.

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