Gestione delle informazioni sullo stato delle funzionalità delle porte personalizzate
L'interfaccia del commutatore estendibile Hyper-V usa l'identificatore di oggetto (OID) seguente per eseguire query sulle informazioni di stato personalizzate per una porta del commutatore estendibile. Queste informazioni sullo stato sono note come informazioni sullo stato della funzionalità della porta :
OID_SWITCH_PORT_FEATURE_STATUS_QUERY
Questa richiesta di metodo OID viene eseguita dal bordo del protocollo dell'opzione estendibile per ottenere le informazioni sullo stato della funzionalità personalizzate per una proprietà di porta specificata.
Una volta restituito correttamente da questa richiesta di 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_PORT_FEATURE_STATUS_PARAMETERS che specifica le informazioni sullo stato della funzionalità personalizzate da restituire.
Nota Per uno stato di funzionalità personalizzato, il membro FeatureStatusType è impostato su NdisSwitchPortPropertyTypeCustom.
Struttura NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM che contiene le informazioni sullo stato relative a una proprietà personalizzata assegnata a una porta del commutatore estendibile.
Quando il bordo del protocollo dell'interruttore estendibile genera la richiesta di OID_SWITCH_PORT_FEATURE_STATUS_QUERY , imposta i membri FeatureStatusCustomBufferLength e FeatureStatusCustomBufferOffset su una posizione 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_PORT_FEATURE_STATUS_QUERY:
L'estensione deve gestire la richiesta OID se gestisce una proprietà di porta del commutatore estendibile personalizzata corrispondente al membro FeatureStatusId della struttura NDIS_SWITCH_PORT_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_PORT_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 BytesNeeded nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie.
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 la proprietà dell'opzione estendibile personalizzata, deve chiamare NdisFOidRequest per inoltrare la richiesta OID allo stack di driver dell'opzione estendibile.
Per altre informazioni su come inoltrare le richieste OID, vedere Filtro delle richieste OID in un driver di filtro NDIS.
Per altre informazioni su come definire e registrare informazioni sullo stato delle funzionalità delle porte, vedere Stato della funzionalità porta personalizzata.