Nota
L'accesso a questa pagina richiede l'autorizzazione. Puoi provare ad accedere o a cambiare directory.
L'accesso a questa pagina richiede l'autorizzazione. Puoi provare a cambiare directory.
Il bordo del protocollo del commutatore estendibile Hyper-V emette una richiesta di set di identificatori di oggetto (OID) di OID_SWITCH_PROPERTY_ADD per notificare alle estensioni del commutatore estendibile l'aggiunta di una proprietà dei criteri switch
Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a un buffer. Questo buffer contiene i dati seguenti:
Struttura NDIS_SWITCH_PROPERTY_PARAMETERS che specifica l'identificazione e il tipo di un criterio switch estendibile.
Buffer delle proprietà che contiene i parametri per un criterio di cambio estendibile. Il buffer delle proprietà contiene una struttura basata sul membro propertyType della struttura NDIS_SWITCH_PROPERTY_PARAMETERS.
Nota A partire da Windows Server 2012, il membro PropertyType deve essere impostato su NdisSwitchPropertyTypeCustom e il buffer delle proprietà deve contenere una struttura NDIS_SWITCH_PROPERTY_CUSTOM.
Osservazioni
Un'estensione di inoltro può gestire la richiesta del set OID di OID_SWITCH_PROPERTY_ADD. Tutti gli altri tipi di estensioni devono chiamare NdisFOidRequest per inoltrare la richiesta OID alla successiva estensione nello stack di driver del commutatore estendibile.
L'estensione può veto l'aggiunta della proprietà switch restituendo NDIS_STATUS_DATA_NOT_ACCEPTED per la richiesta OID. Ad esempio, se un'estensione non può allocare risorse per applicare i criteri aggiornati all'opzione, deve veto alla richiesta di addizione.
Nota 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 di notifica di creazione.
Se l'estensione non ha veto la richiesta OID, deve monitorare lo stato al termine della richiesta. L'estensione deve eseguire questa operazione per determinare se la richiesta OID è stata veto dalle estensioni sottostanti nel percorso di controllo commutatore estendibile o dall'interfaccia del commutatore estendibile.
Per linee guida su come gestire una richiesta di set OID di OID_SWITCH_PROPERTY_ADD, vedere Managing Switch Policies.
Codici di stato restituiti
Se l'estensione di inoltro completa la richiesta del set OID di OID_SWITCH_PROPERTY_ADD, restituisce uno dei codici di stato seguenti.
| Codice di stato | Descrizione |
|---|---|
NDIS_STATUS_DATA_NOT_ACCEPTED |
L'estensione ha veto la notifica di aggiunta dei criteri switch. |
NDIS_STATUS_FAILURE |
La richiesta OID non è riuscita per altri motivi. |
Se l'estensione non completa la richiesta del set OID di OID_SWITCH_PROPERTY_ADD, la richiesta viene completata dal bordo miniport sottostante del commutatore estendibile. Il bordo miniport restituisce il codice di stato seguente.
| Codice di stato | Descrizione |
|---|---|
NDIS_STATUS_SUCCESS |
Richiesta OID completata. |
Fabbisogno
Versione |
Supportato in NDIS 6.30 e versioni successive. |
Intestazione |
Ntddndis.h (include Ndis.h) |