OID_GEN_SUPPORTED_GUIDS

В качестве запроса OID OID_GEN_SUPPORTED_GUIDS запрашивает у драйвера мини-порта массив структур типа NDIS_GUID.

Сведения о версии

Windows Vista и более поздние версии Windows
Поддерживается.

Драйверы NDIS 6.0 и более поздних версий miniport
Необязательный элемент.

Драйверы минипорта NDIS 5.1
Необязательный элемент.

Windows XP
Поддерживается.

Драйверы минипорта NDIS 5.1
Необязательный элемент.

Комментарии

Каждая структура в массиве задает сопоставление пользовательского ИДЕНТИФИКАТОРа GUID (глобально уникального идентификатора) либо пользовательского идентификатора OID, либо NDIS_STATUS, который драйвер мини-порта отправляет через функцию NdisMIndicateStatusEx .

Структура NDIS_GUID определяется следующим образом:

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

Элементы этой структуры содержат следующие сведения:

Guid
Указывает пользовательский GUID, определенный для драйвера мини-порта.

Oid
Указывает пользовательский OID, с которым сопоставляется GUID .

Состояние
Указывает NDIS_STATUS, с которым сопоставляется GUID .

Размер
Задает размер в байтах каждого элемента данных в массиве, возвращаемом драйвером мини-порта. Если установлен флаг fNDIS_GUID_ANSI_STRING или fNDIS_GUID_NDIS_STRING, для параметра Size задано значение -1. В противном случае значение Size указывает размер элемента данных в байтах, который представляет GUID. Этот элемент указывается только в том случае, если установлен флаг fNDIS_GUID_ARRAY.

Флаги
Оператор OR может объединять следующие флаги, чтобы указать, сопоставляется ли GUID с OID или строкой NDIS_STATUS, а также для указания типа данных, предоставленных для GUID:

fNDIS_GUID_TO_OID
Указывает, что структура NDIS_GUID сопоставляет GUID с OID.

fNDIS_GUID_TO_STATUS
Указывает, что структура NDIS_GUID сопоставляет GUID со строкой NDIS_STATUS.

fNDIS_GUID_ANSI_STRING
Указывает, что для GUID предоставляется строка ANSI, заканчивающаяся нулевым значением.

fNDIS_GUID_UNICODE_STRING
Указывает, что для GUID указана строка Юникода.

fNDIS_GUID_ARRAY
Указывает, что для GUID предоставляется массив элементов данных. Указанный размер указывает длину каждого элемента данных в массиве.

fNDIS_GUID_ALLOW_READ
Если задано значение , указывает, что всем пользователям разрешено использовать этот GUID для получения сведений.

fNDIS_GUID_ALLOW_WRITE
Если задано значение , указывает, что всем пользователям разрешено использовать этот GUID для задания сведений.

Примечание По умолчанию пользовательские идентификаторы GUID WMI, предоставляемые драйвером мини-порта, доступны только пользователям с правами администратора. Пользователь с правами администратора всегда может считывать или записывать данные в пользовательский GUID, если драйвер минипорта поддерживает операцию чтения или записи для этого GUID. Установите флаги fNDIS_GUID_ALLOW_READ и fNDIS_GUID_ALLOW_WRITE, чтобы разрешить всем пользователям доступ к пользовательскому GUID.

Обратите внимание, что все пользовательские идентификаторы GUID, зарегистрированные драйвером мини-порта, должны задавать либо fNDIS_GUID_TO_OID, либо fNDIS_GUID_TO_STATUS (никогда не устанавливать оба). Все остальные флаги можно объединить с помощью оператора OR, если применимо.

В следующем примере структура NDIS_GUID сопоставляет GUID с 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};

GUID — это идентификатор, используемый инструментарием управления Windows (WMI) для получения или задания сведений. NDIS перехватывает GUID, отправленный WMI в драйвер NDIS, сопоставляет его с OID и отправляет OID драйверу. Драйвер возвращает элементы данных в NDIS, а затем возвращает данные в WMI.

NDIS также преобразует изменения в состоянии сетевого адаптера в идентификаторы GUID, которые распознаются WMI. Когда драйвер минипорта сообщает об изменении состояния сетевой карты с помощью функции NdisMIndicateStatusEx , NDIS преобразует NDIS_STATUS, указанные драйвером мини-порта, в GUID, который NDIS отправляет в WMI.

Если драйвер минипорта поддерживает таможенные GUID, он должен поддерживать OID_GEN_SUPPORTED_GUIDS. Этот OID возвращает в NDIS сопоставление пользовательских идентификаторов GUID с пользовательскими идентификаторами OID или NDIS_STATUS строками. После запроса к драйверу мини-порта с помощью OID_GEN_SUPPORTED_GUIDS NDIS регистрирует пользовательские GUID драйвера минипорта с помощью WMI.

Требования

Заголовок

Ntddndis.h (включая Ndis.h)

См. также раздел

NdisMIndicateStatusEx