OID_GEN_SUPPORTED_GUIDS

Als Abfrage fordert die OID_GEN_SUPPORTED_GUIDS OID den Miniporttreiber an, ein Array von Strukturen des Typs NDIS_GUID zurückzugeben.

Versionsinformationen

Windows Vista und höhere Versionen von Windows
Unterstützt.

Miniporttreiber NDIS 6.0 und höher
Optional.

NDIS 5.1-Miniporttreiber
Optional.

Windows XP
Unterstützt.

NDIS 5.1-Miniporttreiber
Optional.

Bemerkungen

Jede Struktur im Array gibt die Zuordnung einer benutzerdefinierten GUID (global eindeutiger Bezeichner) zu einer benutzerdefinierten OID oder zu einer NDIS_STATUS an, die der Miniporttreiber über die NdisMIndicateStatusEx-Funktion sendet.

Die NDIS_GUID-Struktur ist wie folgt definiert:

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

Die Member dieser Struktur enthalten die folgenden Informationen:

Guid
Gibt die benutzerdefinierte GUID an, die für den Miniporttreiber definiert ist.

Oid
Gibt die benutzerdefinierte OID an, der GUID zugeordnet ist.

Status
Gibt die NDIS_STATUS an, der Guid zugeordnet ist.

Größe
Gibt die Größe jedes Datenelements in Byte im Array an, das vom Miniporttreiber zurückgegeben wird. Wenn das flag fNDIS_GUID_ANSI_STRING oder fNDIS_GUID_NDIS_STRING festgelegt ist, wird Größe auf -1 festgelegt. Andernfalls gibt Size die Größe des Datenelements in Byte an, das die GUID darstellt. Dieser Member wird nur angegeben, wenn das flag fNDIS_GUID_ARRAY festgelegt ist.

Flags
Die folgenden Flags können vom OR-Operator kombiniert werden, um anzugeben, ob die GUID einer OID oder einer NDIS_STATUS Zeichenfolge zugeordnet ist, und um den Datentyp anzugeben, der für die GUID bereitgestellt wird:

fNDIS_GUID_TO_OID
Gibt an, dass die NDIS_GUID-Struktur eine GUID einer OID zuordnet.

fNDIS_GUID_TO_STATUS
Gibt an, dass die NDIS_GUID-Struktur eine GUID einer NDIS_STATUS Zeichenfolge zuordnet.

fNDIS_GUID_ANSI_STRING
Gibt an, dass eine NULL-endende ANSI-Zeichenfolge für die GUID bereitgestellt wird.

fNDIS_GUID_UNICODE_STRING
Gibt an, dass eine Unicode-Zeichenfolge für die GUID bereitgestellt wird.

fNDIS_GUID_ARRAY
Gibt an, dass ein Array von Datenelementen für die GUID bereitgestellt wird. Die angegebene Größe gibt die Länge der einzelnen Datenelemente im Array an.

fNDIS_GUID_ALLOW_READ
Gibt bei Festlegung an, dass alle Benutzer diese GUID zum Abrufen von Informationen verwenden dürfen.

fNDIS_GUID_ALLOW_WRITE
Wenn festgelegt, gibt an, dass alle Benutzer diese GUID verwenden dürfen, um Informationen festzulegen.

Hinweis Standardmäßig sind benutzerdefinierte WMI-GUIDs, die von einem Miniporttreiber bereitgestellt werden, nur für Benutzer mit Administratorrechten zugänglich. Ein Benutzer mit Administratorrechten kann immer eine benutzerdefinierte GUID lesen oder in eine benutzerdefinierte GUID schreiben, wenn der Miniporttreiber den Lese- oder Schreibvorgang für diese GUID unterstützt. Legen Sie die flags fNDIS_GUID_ALLOW_READ und fNDIS_GUID_ALLOW_WRITE fest, damit alle Benutzer auf eine benutzerdefinierte GUID zugreifen können.

Beachten Sie, dass alle benutzerdefinierten GUIDs, die von einem Miniporttreiber registriert werden, entweder fNDIS_GUID_TO_OID oder fNDIS_GUID_TO_STATUS (nie beides) festlegen müssen. Alle anderen Flags können ggf. mithilfe des OR-Operators kombiniert werden.

Im folgenden Beispiel ordnet eine NDIS_GUID-Struktur eine GUID OID_802_3_MULTICAST_LIST zu:

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

Eine GUID ist ein Bezeichner, der von der Windows-Verwaltungsinstrumentation (WMI) zum Abrufen oder Festlegen von Informationen verwendet wird. NDIS fängt eine von WMI an einen NDIS-Treiber gesendete GUID ab, ordnet die GUID einer OID zu und sendet die OID an den Treiber. Der Treiber gibt die Datenelemente an NDIS zurück, die dann die Daten an WMI zurückgibt.

NDIS übersetzt auch Änderungen in NIC-status in GUIDs, die von WMI erkannt werden. Wenn ein Miniporttreiber eine Änderung der NIC-status mithilfe der NdisMIndicateStatusEx-Funktion meldet, übersetzt NDIS die vom Miniporttreiber angegebene NDIS_STATUS in eine GUID, die NDIS an WMI sendet.

Wenn ein Miniporttreiber Zoll-GUIDs unterstützt, muss er OID_GEN_SUPPORTED_GUIDS unterstützen. Diese OID gibt die Zuordnung benutzerdefinierter GUIDs zu benutzerdefinierten OIDs oder NDIS_STATUS Zeichenfolgen an NDIS zurück. Nach dem Abfragen des Miniporttreibers mithilfe von OID_GEN_SUPPORTED_GUIDS registriert NDIS die benutzerdefinierten GUIDs des Miniporttreibers bei WMI.

Anforderungen

Weitere Informationen

NdisMIndicateStatusEx