OID_GEN_CO_SUPPORTED_GUIDS

De OID_GEN_CO_SUPPORTED_GUIDS OID vraagt het minipoortstuurprogramma om een matrix met structuren van het type NDIS_GUID te retourneren. Elke structuur in de matrix geeft de toewijzing van een aangepaste GUID (globally unique identifier) aan een aangepaste OID of aan een NDIS_STATUS die het minipoortstuurprogramma verzendt via NdisMCoIndicateStatusEx.

De NDIS_GUID structuur wordt als volgt gedefinieerd:

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

De leden van deze structuur bevatten de volgende informatie:

guid-
De aangepaste GUID die is gedefinieerd voor het minipoortstuurprogramma.

Oid-
De aangepaste OID waarmee Guid wordt toegewezen.

status
De NDIS_STATUS waarop Guid wordt toegewezen.

grootte
Wanneer de vlag fNDIS_GUID_ARRAY is ingesteld, geeft Grootte de grootte op in bytes van elk gegevensitem in de matrix die wordt geretourneerd door het minipoortstuurprogramma. Als de vlag fNDIS_GUID_ANSI_STRING of fNDIS_GUID_NDIS_STRING is ingesteld, wordt Grootte ingesteld op -1. Anders geeft Grootte de grootte op in bytes van het gegevensitem dat de GUID vertegenwoordigt.

vlaggen
De volgende vlaggen kunnen samen ORed zijn om aan te geven of de GUID wordt toegewezen aan een OID of aan een NDIS_STATUS tekenreeks en om het type gegevens aan te geven dat is opgegeven voor de GUID:

fNDIS_GUID_TO_OID
Wanneer deze is ingesteld, geeft u aan dat de NDIS_GUID structuur een GUID toewijst aan een OID.

fNDIS_GUID_TO_STATUS
Wanneer deze is ingesteld, geeft u aan dat de NDIS_GUID structuur een GUID toewijst aan een NDIS_STATUS tekenreeks.

fNDIS_GUID_ANSI_STRING
Wanneer deze is ingesteld, geeft u aan dat er een ansi-tekenreeks met null-beëindiging wordt opgegeven voor de GUID.

fNDIS_GUID_UNICODE_STRING
Wanneer deze is ingesteld, geeft u aan dat er een Unicode-tekenreeks wordt opgegeven voor de GUID.

fNDIS_GUID_ARRAY
Wanneer deze is ingesteld, geeft u aan dat er een matrix met gegevensitems wordt opgegeven voor de GUID. De opgegeven grootte geeft de lengte aan van elk gegevensitem in de matrix.

fNDIS_GUID_ALLOW_READ
Wanneer deze optie is ingesteld, geeft u aan dat alle gebruikers een query mogen uitvoeren op deze GUID.

fNDIS_GUID_ALLOW_WRITE
Wanneer deze optie is ingesteld, geeft u aan dat alle gebruikers deze GUID mogen instellen.

Opmerkingen

Notitie

Aangepaste WMI-GUID's die door een minipoortstuurprogramma worden geleverd, zijn standaard alleen toegankelijk voor gebruikers met beheerdersbevoegdheden. Een gebruiker met beheerdersbevoegdheden kan altijd lezen of schrijven naar een aangepaste GUID als het minipoortstuurprogramma ondersteuning biedt voor de lees- of schrijfbewerking voor die GUID. Stel de fNDIS_GUID_ALLOW_READ en fNDIS_GUID_ALLOW_WRITE vlaggen in om alle gebruikers toegang te geven tot een aangepaste GUID.

Alle aangepaste GUID's die zijn geregistreerd door een minipoortstuurprogramma, moeten fNDIS_GUID_TO_OID of fNDIS_GUID_TO_STATUS instellen (nooit beide instellen). Alle andere vlaggen kunnen worden gecombineerd met behulp van de OPERATOR OR, indien van toepassing.

In het volgende voorbeeld wijst een NDIS_GUID structuur een GUID toe aan 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};

Een GUID is een id die wordt gebruikt door WMI (Windows Management Instrumentation) om informatie te verkrijgen of in te stellen. NDIS onderschept een GUID die door WMI wordt verzonden naar een NDIS-stuurprogramma, wijst de GUID toe aan een OID en stuurt de OID naar het stuurprogramma. Het stuurprogramma retourneert de gegevensitems naar NDIS, die vervolgens de gegevens retourneert naar WMI.

NDIS vertaalt ook wijzigingen in de NIC-status naar GUID's die worden herkend door WMI. Wanneer een minipoortstuurprogramma een wijziging in de NIC-status rapporteert met NdisMCoIndicateStatusEx, vertaalt NDIS de NDIS_STATUS aangegeven door het minipoortstuurprogramma in een GUID die NDIS naar WMI verzendt.

Als een verbindingsgeoriënteerd miniportstuurprogramma douane-GUID's ondersteunt, moet deze ondersteuning bieden voor OID_GEN_CO_SUPPORTED_GUIDS, die terugkeert naar NDIS de toewijzing van aangepaste GUID's aan aangepaste OID's of NDIS_STATUS tekenreeksen. Na het uitvoeren van een query op het minipoortstuurprogramma met OID_GEN_CO_SUPPORTED_GUIDS, registreert NDIS de aangepaste GUID's van het minipoortstuurprogramma met WMI.

Eisen

Versie: Windows Vista en hoger Header: Ntddndis.h (inclusief Ndis.h)