OID_GEN_SUPPORTED_GUIDS
В качестве запроса OID OID_GEN_SUPPORTED_GUIDS запрашивает у драйвера мини-порта массив структур типа NDIS_GUID.
Сведения о версии
Windows Vista и более поздние версии Windows
Поддерживается.
Драйверы NDIS 6.0 и более поздних версий miniport
Необязательный элемент.
Драйверы минипорта NDIS 5.1
Необязательный элемент.
Драйверы минипорта 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) |