Gestione delle informazioni sullo stato delle funzionalità del commutatore personalizzato
L'interfaccia commutatore estendibile Hyper-V usa l'identificatore di oggetto seguente (OID) per eseguire query su informazioni di stato personalizzate per l'commutatore estendibile. Queste informazioni sullo stato sono note come informazioni sullo stato delle funzionalità switch :
OID_SWITCH_FEATURE_STATUS_QUERY
Questa richiesta di metodo OID viene emessa dal bordo del protocollo del commutatore estendibile per ottenere le informazioni sullo stato della funzionalità personalizzate per una proprietà switch specificata.
Dopo aver restituito correttamente la richiesta di questo metodo OID, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a un buffer. Questo buffer contiene i dati seguenti:
Struttura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS che specifica le informazioni sullo stato delle funzionalità personalizzate da restituire.
Nota Per uno stato di funzionalità personalizzato, il membro FeatureStatusType è impostato su NdisSwitchPropertyTypeCustom.
Struttura NDIS_SWITCH_FEATURE_STATUS_CUSTOM contenente le informazioni sullo stato relative a una proprietà personalizzata assegnata a una porta di commutatore estendibile.
Quando il bordo del protocollo dell'commutatore estendibile genera la richiesta di OID_SWITCH_FEATURE_STATUS_QUERY , imposta i membri FeatureStatusCustomBufferLength e FeatureStatusCustomBufferOffset su un percorso nel membro InformationBuffer che l'estensione può usare per restituire le informazioni sullo stato della funzionalità.
L'estensione del commutatore estendibile deve seguire queste linee guida quando riceve una richiesta di metodo OID di OID_SWITCH_FEATURE_STATUS_QUERY:
L'estensione deve gestire la richiesta OID se gestisce uno stato di funzionalità di commutatore estendibile personalizzato corrispondente al membro FeatureStatusId della struttura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS .
Se l'estensione gestisce la richiesta del metodo OID, deve restituire le informazioni sullo stato della funzionalità corrispondenti ai parametri specificati dalla struttura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS .
Se il buffer di stato della funzionalità è troppo piccolo, l'estensione deve non riuscire la richiesta OID con NDIS_STATUS_INVALID_LENGTH. L'estensione deve impostare i DATI. SET_INFORMATION. Membro ByteNeeded nella struttura NDIS_OID_REQUEST alla dimensione minima del buffer necessaria.
In caso contrario, l'estensione deve restituire le informazioni sullo stato della funzionalità e completare la richiesta OID con NDIS_STATUS_SUCCESS.
Se l'estensione non gestisce lo stato della funzionalità di commutatore estendibile personalizzato, deve chiamare NdisFOidRequest per inoltrare la richiesta OID nello stack di driver di commutatore estendibile.
Per altre informazioni su come inoltrare richieste OID, vedere Filtro delle richieste OID in un driver di filtro NDIS.
Per altre informazioni su come definire e registrare le informazioni sullo stato delle funzionalità del commutatore, vedere Stato delle funzionalità switch personalizzato.