OID_GEN_CO_SUPPORTED_GUIDS

Die OID_GEN_CO_SUPPORTED_GUIDS OID fordert den Miniporttreiber auf, ein Array von Strukturen des Typs NDIS_GUID zurückzugeben. Jede Struktur im Array gibt die Zuordnung einer benutzerdefinierten GUID (global eindeutiger Bezeichner) zu einem benutzerdefinierten OID oder zu einem NDIS_STATUS an, den der Miniporttreiber über NdisMCoIndicateStatusExsendet.

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-
Die für den Miniporttreiber definierte benutzerdefinierte GUID.

Oid-
Das benutzerdefinierte OID, dem Guid zugeordnet ist.

Status-
Die NDIS_STATUS, der GUID- zugeordnet ist.

Größe
Wenn das fNDIS_GUID_ARRAY Flag festgelegt ist, gibt Size 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.

Flags
Die folgenden Flags können zusammengehören werden, um anzugeben, ob die GUID einem OID oder einer NDIS_STATUS Zeichenfolge zugeordnet ist und um den Typ der für die GUID bereitgestellten Daten anzugeben:

fNDIS_GUID_TO_OID
Wenn festgelegt, gibt an, dass die NDIS_GUID-Struktur eine GUID einem OID zuordnet.

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

fNDIS_GUID_ANSI_STRING
Wenn festgelegt, gibt an, dass eine NULL-beendete ANSI-Zeichenfolge für die GUID bereitgestellt wird.

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

fNDIS_GUID_ARRAY
Wenn festgelegt, 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 an, dass alle Benutzer diese GUID abfragen dürfen.

fNDIS_GUID_ALLOW_WRITE
Gibt an, dass alle Benutzer diese GUID festlegen dürfen.

Bemerkungen

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_GEN_CO_RCV_PDUS_NO_BUFFER zu:

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

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 GUID ab, die von WMI an einen NDIS-Treiber gesendet wird, 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 mit NdisMCoIndicateStatusExmeldet, übersetzt NDIS die vom Miniporttreiber angegebenen NDIS_STATUS in eine GUID, die NDIS an WMI sendet.

Wenn ein verbindungsorientierter Miniporttreiber Zoll-GUIDs unterstützt, muss er OID_GEN_CO_SUPPORTED_GUIDS unterstützen, was zur Zuordnung benutzerdefinierter GUIDs zu benutzerdefinierten OIDs oder NDIS_STATUS Zeichenfolgen zurückgibt. Nach der Abfrage des Miniporttreibers mit OID_GEN_CO_SUPPORTED_GUIDS registriert NDIS die benutzerdefinierten GUIDs des Miniporttreibers bei WMI.

Anforderungen

Version: Windows Vista und höher Header-: Ntddndis.h (enthalten Ndis.h)