OID_GEN_SUPPORTED_GUIDS

Jako dotaz OID_GEN_SUPPORTED_GUIDS identifikátor požaduje ovladač miniportu, aby vrátil pole struktur typu NDIS_GUID.

informace o verzi

Windows Vista a novějších verzích Windows
Podporovaný.

ovladače miniportu NDIS 6.0 a novější
Volitelný.

ovladače miniportu NDIS 5.1
Volitelný.

Windows XP
Podporovaný.

ovladače miniportu NDIS 5.1
Volitelný.

Poznámky

Každá struktura v poli určuje mapování vlastního identifikátoru GUID (globálně jedinečný identifikátor) na vlastní identifikátor OID nebo na NDIS_STATUS, které ovladač miniportu odesílá prostřednictvím funkce NdisMIndicateStatusEx.

Struktura NDIS_GUID je definována takto:

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

Členové této struktury obsahují následující informace:

guid
Určuje vlastní identifikátor GUID definovaný pro ovladač miniportu.

Oid
Určuje vlastní identifikátor OID, na který identifikátor GUID mapuje.

stavu
Určuje NDIS_STATUS, na který identifikátor GUID mapuje.

velikosti
Určuje velikost v bajtech každé datové položky v poli vrácené ovladačem miniportu. Pokud je nastaven příznak fNDIS_GUID_ANSI_STRING nebo fNDIS_GUID_NDIS_STRING, Velikost je nastavena na -1. V opačném případě Velikost určuje velikost v bajtech datové položky, kterou identifikátor GUID představuje. Tento člen je určen pouze v případě, že je nastaven příznak fNDIS_GUID_ARRAY.

příznaky
Operátor OR může zkombinovat následující příznaky, které indikují, jestli se identifikátor GUID mapuje na identifikátor OID nebo na řetězec NDIS_STATUS a určuje typ dat zadaných pro identifikátor GUID:

fNDIS_GUID_TO_OID
Označuje, že struktura NDIS_GUID mapuje identifikátor GUID na identifikátor OID.

fNDIS_GUID_TO_STATUS
Označuje, že struktura NDIS_GUID mapuje identifikátor GUID na řetězec NDIS_STATUS.

fNDIS_GUID_ANSI_STRING
Označuje, že řetězec ANSI ukončený hodnotou null je zadaný pro identifikátor GUID.

fNDIS_GUID_UNICODE_STRING
Označuje, že řetězec Unicode je zadán pro identifikátor GUID.

fNDIS_GUID_ARRAY
Označuje, že pole datových položek je zadáno pro identifikátor GUID. Zadaná Velikost označuje délku každé datové položky v poli.

fNDIS_GUID_ALLOW_READ
Při nastavení označuje, že všichni uživatelé mají povoleno používat tento identifikátor GUID k získání informací.

fNDIS_GUID_ALLOW_WRITE
Při nastavení označuje, že všichni uživatelé mohou k nastavení informací použít tento identifikátor GUID.

Poznámka Ve výchozím nastavení jsou vlastní identifikátory GUID rozhraní WMI poskytované ovladačem miniportu přístupné pouze uživatelům s oprávněními správce. Uživatel s oprávněními správce může vždy číst nebo zapisovat do vlastního identifikátoru GUID, pokud ovladač miniportu podporuje operaci čtení nebo zápisu pro tento identifikátor GUID. Nastavte příznaky fNDIS_GUID_ALLOW_READ a fNDIS_GUID_ALLOW_WRITE tak, aby všichni uživatelé mohli přistupovat k vlastnímu identifikátoru GUID.

Všimněte si, že všechny vlastní identifikátory GUID zaregistrované ovladačem miniportu musí být nastaveny buď fNDIS_GUID_TO_OID, nebo fNDIS_GUID_TO_STATUS (nikdy nenastavujte obojí). Všechny ostatní příznaky mohou být sloučeny pomocí operátoru OR podle potřeby.

V následujícím příkladu mapuje struktura NDIS_GUID identifikátor GUID na OID_802_3_MULTICAST_LIST:

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

Identifikátor GUID je identifikátor používaný rozhraním WMI (Windows Management Instrumentation) k získání nebo nastavení informací. NDIS zachytí identifikátor GUID odeslaný rozhraním WMI na ovladač NDIS, mapuje identifikátor GUID na identifikátor OID a odešle identifikátor OID ovladači. Ovladač vrátí datové položky do rozhraní NDIS, které pak vrátí data do rozhraní WMI.

NDIS také překládá změny ve stavu síťové karty na identifikátory GUID, které služba WMI rozpozná. Když ovladač miniportu hlásí změnu stavu síťové karty pomocí funkce NdisMIndicateStatusEx, přeloží NDIS NDIS_STATUS označený ovladačem miniportu do identifikátoru GUID, který NDIS odesílá do rozhraní WMI.

Pokud ovladač miniportu podporuje celní identifikátory GUID, musí podporovat OID_GEN_SUPPORTED_GUIDS. Tento identifikátor OID se vrátí do NDIS mapování vlastních identifikátorů GUID na vlastní identifikátory OID nebo NDIS_STATUS řetězce. Po dotazování ovladače miniportu pomocí OID_GEN_SUPPORTED_GUIDS zaregistruje rozhraní NDIS vlastní identifikátory GUID ovladače miniportu ve službě WMI.

Požadavky

Záhlaví

Ntddndis.h (včetně Ndis.h)

Viz také

NdisMIndicateStatusEx