OID_GEN_CO_SUPPORTED_GUIDS

L'OID OID_GEN_CO_SUPPORTED_GUIDS richiede al driver miniport di restituire una matrice di strutture del tipo NDIS_GUID. Ogni struttura nella matrice specifica il mapping di un GUID personalizzato (identificatore univoco globale) a un OID personalizzato o a un NDIS_STATUS inviato dal driver miniport tramite NdisMCoIndicateStatusEx.

La struttura NDIS_GUID è definita come segue:

typedef struct _NDIS_GUID {
    GUID    Guid;
    union {
        NDIS_OID    Oid;
        NDIS_STATUS Status;
    };
    ULONG   Size;
    ULONG   Flags;
} NDIS_GUID, *PNDIS_GUID;

I membri di questa struttura contengono le informazioni seguenti:

guid
GUID personalizzato definito per il driver miniport.

Oid
OID personalizzato a cui guid mappa.

stato
NDIS_STATUS a cui guid mappa.

dimensioni
Quando viene impostato il flag fNDIS_GUID_ARRAY, Size specifica le dimensioni in byte di ogni elemento di dati nella matrice restituita dal driver miniport. Se il flag fNDIS_GUID_ANSI_STRING o fNDIS_GUID_NDIS_STRING è impostato, dimensioni è impostato su -1. In caso contrario, Dimensioni specifica le dimensioni in byte dell'elemento di dati rappresentato dal GUID.

flag
I flag seguenti possono essere ORed insieme per indicare se il GUID è mappato a un OID o a una stringa NDIS_STATUS e per indicare il tipo di dati forniti per il GUID:

fNDIS_GUID_TO_OID
Se impostato, indica che la struttura NDIS_GUID esegue il mapping di un GUID a un OID.

fNDIS_GUID_TO_STATUS
Se impostato, indica che la struttura NDIS_GUID esegue il mapping di un GUID a una stringa NDIS_STATUS.

fNDIS_GUID_ANSI_STRING
Se impostato, indica che viene fornita una stringa ANSI con terminazione Null per il GUID.

fNDIS_GUID_UNICODE_STRING
Se impostato, indica che viene specificata una stringa Unicode per il GUID.

fNDIS_GUID_ARRAY
Se impostato, indica che viene fornita una matrice di elementi di dati per il GUID. La dimensione specificata indica la lunghezza di ogni elemento di dati nella matrice.

fNDIS_GUID_ALLOW_READ
Se impostato, indica che tutti gli utenti possono eseguire query su questo GUID.

fNDIS_GUID_ALLOW_WRITE
Se impostato, indica che tutti gli utenti possono impostare questo GUID.

Osservazioni

Nota

Per impostazione predefinita, i GUID WMI personalizzati forniti da un driver miniport sono accessibili solo agli utenti con privilegi di amministratore. Un utente con privilegi di amministratore può sempre leggere o scrivere in un GUID personalizzato se il driver miniport supporta l'operazione di lettura o scrittura per tale GUID. Impostare i flag fNDIS_GUID_ALLOW_READ e fNDIS_GUID_ALLOW_WRITE per consentire a tutti gli utenti di accedere a un GUID personalizzato.

Si noti che tutti i GUID personalizzati registrati da un driver miniport devono impostare fNDIS_GUID_TO_OID o fNDIS_GUID_TO_STATUS (non impostare mai entrambi). Tutti gli altri flag possono essere combinati usando l'operatore OR come applicabile.

Nell'esempio seguente una struttura NDIS_GUID esegue il mapping di un GUID a OID_GEN_CO_RCV_PDUS_NO_BUFFER:

NDIS_GUID NdisGuid =  {{0x0a214809, 0xe35f, 0x11d0, 0x96, 0x92, 0x00,
 0xc0, 0x4f, 0xc3, 0x35, 0x8c},
 GUID_NDIS_GEN_CO_RCV_PDUS_NO_BUFFER,
 OID_GEN_CO_RCV_PDUS_NO_BUFFER,
 4,
 fNDIS_GUID_TO_OID};

Un GUID è un identificatore usato da Strumentazione gestione Windows (WMI) per ottenere o impostare informazioni. NDIS intercetta un GUID inviato da WMI a un driver NDIS, esegue il mapping del GUID a un OID e invia l'OID al driver. Il driver restituisce gli elementi di dati a NDIS, che quindi restituisce i dati a WMI.

NDIS converte anche le modifiche apportate allo stato della scheda di interfaccia di rete in GUID riconosciuti da WMI. Quando un driver miniport segnala una modifica dello stato della scheda di interfaccia di rete con NdisMCoIndicateStatusEx, NDIS converte il NDIS_STATUS indicato dal driver miniport in un GUID inviato da NDIS a WMI.

Se un driver miniport orientato alla connessione supporta GUID doganali, deve supportare OID_GEN_CO_SUPPORTED_GUIDS, che restituisce a NDIS il mapping di GUID personalizzati a OID personalizzati o NDIS_STATUS stringhe. Dopo aver eseguito una query sul driver miniport con OID_GEN_CO_SUPPORTED_GUIDS, NDIS registra i GUID personalizzati del driver miniport con WMI.

Fabbisogno

versione: Windows Vista e versioni successive Intestazione: Ntddndis.h (include Ndis.h)