OID_GEN_SUPPORTED_GUIDS
Als Abfrage fordert die OID_GEN_SUPPORTED_GUIDS OID den Miniporttreiber auf, ein Array von Strukturen des Typs NDIS_GUID zurückzugeben.
Versionsinformationen
Windows Vista und neuere Versionen von Windows
Abgestützt.
NDIS 6.0 und höher Miniporttreiber
Wahlfrei.
NDIS 5.1 Miniporttreiber
Wahlfrei.
NDIS 5.1 Miniporttreiber
Wahlfrei.
Bemerkungen
Jede Struktur im Array gibt die Zuordnung einer benutzerdefinierten GUID (global eindeutiger Bezeichner) entweder einem benutzerdefinierten OID oder einem NDIS_STATUS an, den der Miniporttreiber über die NdisMIndicateStatusEx--Funktion sendet.
Die NDIS_GUID-Struktur wird 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 Elemente dieser Struktur enthalten die folgenden Informationen:
GUID-
Gibt die benutzerdefinierte GUID an, die für den Miniporttreiber definiert ist.
Oid-
Gibt das benutzerdefinierte OID an, dem GUID- zugeordnet wird.
Status-
Gibt die NDIS_STATUS an, der GUID- zugeordnet wird.
Größe
Gibt die Größe in Byte jedes Datenelements im Array an, das vom Miniporttreiber zurückgegeben wird. Wenn das fNDIS_GUID_ANSI_STRING- oder fNDIS_GUID_NDIS_STRING-Flag festgelegt ist, wird Größe auf -1 festgelegt. Andernfalls gibt Size die Größe in Byte des Datenelements an, das die GUID darstellt. Dieses Element wird nur angegeben, wenn das fNDIS_GUID_ARRAY Flag festgelegt ist.
Flags
Die folgenden Flags können vom OR-Operator kombiniert werden, um anzugeben, ob die GUID einem 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 einer OID eine GUID zuordnet.
fNDIS_GUID_TO_STATUS
Gibt an, dass die NDIS_GUID-Struktur einer NDIS_STATUS Zeichenfolge eine GUID zuordnet.
fNDIS_GUID_ANSI_STRING
Gibt an, dass für die GUID eine NULL-gekündigte ANSI-Zeichenfolge angegeben 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 Size gibt die Länge der einzelnen Datenelemente im Array an.
fNDIS_GUID_ALLOW_READ
Gibt an, dass alle Benutzer diese GUID zum Abrufen von Informationen verwenden dürfen.
fNDIS_GUID_ALLOW_WRITE
Gibt an, dass alle Benutzer diese GUID zum Festlegen von Informationen verwenden dürfen.
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 schreiben, wenn der Miniporttreiber den Lese- oder Schreibvorgang für diese GUID unterstützt. Legen Sie die Kennzeichnungen fNDIS_GUID_ALLOW_READ und fNDIS_GUID_ALLOW_WRITE fest, damit alle Benutzer auf eine benutzerdefinierte GUID zugreifen können.
Beachten Sie, dass alle von einem Miniporttreiber registrierten benutzerdefinierten GUIDs entweder fNDIS_GUID_TO_OID oder fNDIS_GUID_TO_STATUS festlegen müssen (nie beides festgelegt). Alle anderen Kennzeichnungen können mit dem OR-Betreiber gegebenenfalls 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 (Windows Management Instrumentation, 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 einem OID zu und sendet das 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 am NIC-Status in GUIDs, die von WMI erkannt werden. Wenn ein Miniporttreiber eine Änderung des NIC-Status mithilfe der funktion NdisMIndicateStatusEx meldet, übersetzt NDIS die vom Miniporttreiber angegebenen 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 kehrt zur NDIS-Zuordnung benutzerdefinierter GUIDs zu benutzerdefinierten OIDs oder NDIS_STATUS Zeichenfolgen zurück. Nach der Abfrage des Miniporttreibers mithilfe von OID_GEN_SUPPORTED_GUIDS registriert NDIS die benutzerdefinierten GUIDs des Miniporttreibers bei WMI.
Anforderungen
Kopfball |
Ntddndis.h (include Ndis.h) |