Een NDIS_GUID structuur invullen

Een 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;

Als u een GUID wilt verkrijgen voor de Guid- lid van de structuur, kunt u de Uuidgen.exe toepassing uitvoeren. Zie Interface-UUID's genererenvoor meer informatie over deze toepassing.

De Oid of Status element is een ULONG die een OID-code vertegenwoordigt. NDIS 6.0 wijst aangepaste statusindicaties niet toe aan WMI-GUID's.

Als de NDIS_GUID structuur een OID toegeeft die een matrix met gegevensitems retourneert, geeft de Grootte lid de grootte, in bytes, van elk gegevensitem in de matrix aan. Als de gegevens geen matrix zijn, geeft de Grootte lid de grootte van de gegevens op. Als de grootte van de gegevensitems variabel is of als de OID geen gegevens retourneert, moet de Grootte lid -1 zijn.

Een bitwise OR van de volgende waarden voor het Flags-lidmaatschap duidt het type gegevens dat is gekoppeld aan de GUID aan.

fNDIS_GUID_TO_OID
Wanneer deze vlag is ingesteld, wijst de NDIS_GUID structuur een GUID toe aan een OID.

fNDIS_GUID_TO_STATUS
Gereserveerd voor NDIS. Minipoortstuurprogramma's mogen deze flag niet gebruiken.

fNDIS_GUID_ANSI_STRING
Wanneer deze vlag is ingesteld, wordt er een null-beëindigde ANSI-tekenreeks opgegeven voor de GUID.

fNDIS_GUID_UNICODE_STRING
Wanneer deze vlag is ingesteld, wordt er een Unicode-tekenreeks opgegeven voor de GUID.

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

fNDIS_GUID_ALLOW_READ
Wanneer deze vlag is ingesteld, mogen alle gebruikers deze GUID gebruiken om informatie te verkrijgen.

fNDIS_GUID_ALLOW_WRITE
Wanneer deze vlag is ingesteld, mogen alle gebruikers deze GUID gebruiken om informatie in te stellen.

Opmerking Standaard zijn aangepaste WMI-GUID's die een minipoortstuurprogramma levert 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. U kunt de fNDIS_GUID_ALLOW_READ en fNDIS_GUID_ALLOW_WRITE vlaggen zo instellen dat alle gebruikers toegang hebben tot een aangepaste GUID.

Houd er rekening mee dat voor alle aangepaste GUID's die een stuurprogramma registreert, het stuurprogramma fNDIS_GUID_TO_OID moet instellen. Minipoortdrivers mogen nooit fNDIS_GUID_TO_STATUS instellen. Alle andere vlaggen kunnen worden gecombineerd met behulp van een bitsgewijze OR-bewerking.