OID_GEN_SUPPORTED_GUIDS

Come query, il OID_GEN_SUPPORTED_GUIDS OID richiede al driver miniport di restituire una matrice di strutture del tipo NDIS_GUID.

Informazioni sulla versione

Windows Vista e versioni successive di Windows
Supportata.

Driver miniport NDIS 6.0 e versioni successive
Facoltativa.

Driver miniport NDIS 5.1
Facoltativa.

Windows XP
Supportata.

Driver miniport NDIS 5.1
Facoltativa.

Commenti

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 la funzione NdisMIndicateStatusEx .

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
Specifica il GUID personalizzato definito per il driver miniport.

Oid
Specifica l'OID personalizzato a cui viene mappato il Guid .

Stato
Specifica il NDIS_STATUS a cui viene mappato il GUID .

Dimensione
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, Size è impostato su -1. In caso contrario, Size specifica le dimensioni in byte dell'elemento di dati rappresentato dal GUID. Questo membro viene specificato solo quando viene impostato il flag di fNDIS_GUID_ARRAY.

Bandiere
I flag seguenti possono essere combinati dall'operatore OR per indicare se il GUID esegue il mapping a un OID o a una stringa NDIS_STATUS e per indicare il tipo di dati fornito per il GUID:

fNDIS_GUID_TO_OID
Indica che la struttura NDIS_GUID esegue il mapping di un GUID a un OID.

fNDIS_GUID_TO_STATUS
Indica che la struttura NDIS_GUID esegue il mapping di un GUID a una stringa NDIS_STATUS.

fNDIS_GUID_ANSI_STRING
Indica che viene fornita una stringa ANSI con terminazione Null per il GUID.

fNDIS_GUID_UNICODE_STRING
Indica che viene fornita una stringa Unicode per il GUID.

fNDIS_GUID_ARRAY
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 usare questo GUID per ottenere informazioni.

fNDIS_GUID_ALLOW_WRITE
Se impostato, indica che tutti gli utenti possono usare questo GUID per impostare le informazioni.

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_802_3_MULTICAST_LIST:

NDIS_GUID    NdisGuid = {{0x44795701, 0xa61b, 0x11d0, 0x8d, 0xd4,
                          0x00, 0xc0, 0x4f, 0xc3,
                          0x35, 0x8c},
                          OID_802_3_MULTICAST_LIST,
                          6,
                          fNDIS_GUID_TO_OID | fNDIS_GUID_ARRAY};

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 nello 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 tramite la funzione NdisMIndicateStatusEx , NDIS converte il NDIS_STATUS indicato dal driver miniport in un GUID inviato da NDIS a WMI.

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

Requisiti

Vedi anche

NdisMIndicateStatusEx