OID_GEN_CO_SUPPORTED_GUIDS

Il OID_GEN_CO_SUPPORTED_GUIDS OID 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 che il driver miniport invia 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 esegue il mapping di Guid .

Status
NDIS_STATUS a cui viene mappato guid .

Dimensione
Quando viene impostato il flag di 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 su -1. In caso contrario, Size 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 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
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 fornita 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 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.

Commenti

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 (mai impostato 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 nello stato della scheda di interfaccia di rete in GUID riconosciute 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 che invia a WMI.

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

Requisiti

Versione: Windows Vista e intestazione successiva: Ntddndis.h (include Ndis.h)