OID_GEN_SUPPORTED_GUIDS
Jako zapytanie identyfikator OID OID_GEN_SUPPORTED_GUIDS żąda sterownika miniportu, aby zwrócić tablicę struktur typu NDIS_GUID.
informacje o wersji
Windows Vista i nowszych wersjach systemu Windows
Obsługiwane.
sterowników miniportu NDIS 6.0 i nowszych
Fakultatywny.
sterowniki miniportu NDIS 5.1
Fakultatywny.
sterowniki miniportu NDIS 5.1
Fakultatywny.
Uwagi
Każda struktura w tablicy określa mapowanie niestandardowego identyfikatora GUID (globalnie unikatowego identyfikatora) na niestandardowy identyfikator OID lub NDIS_STATUS, które sterownik miniportu wysyła za pośrednictwem funkcji NdisMIndicateStatusEx.
Struktura NDIS_GUID jest zdefiniowana w następujący sposób:
typedef struct _NDIS_GUID {
GUID Guid;
union {
NDIS_OID Oid;
NDIS_STATUS Status;
};
ULONG Size;
ULONG Flags;
} NDIS_GUID, *PNDIS_GUID;
Elementy członkowskie tej struktury zawierają następujące informacje:
guid
Określa niestandardowy identyfikator GUID zdefiniowany dla sterownika miniportu.
Oid
Określa niestandardowy identyfikator OID, do którego mapuje guid.
stanu
Określa NDIS_STATUS, do których mapuje guid.
rozmiar
Określa rozmiar w bajtach każdego elementu danych w tablicy zwracanej przez sterownik miniportu. Jeśli ustawiono flagę fNDIS_GUID_ANSI_STRING lub fNDIS_GUID_NDIS_STRING, rozmiar ma wartość -1. W przeciwnym razie Rozmiar określa rozmiar w bajtach elementu danych reprezentowanego przez identyfikator GUID. Ten element członkowski jest określony tylko wtedy, gdy jest ustawiona flaga fNDIS_GUID_ARRAY.
flagi
Następujące flagi można połączyć za pomocą operatora OR, aby wskazać, czy identyfikator GUID jest mapowany na identyfikator OID, czy na ciąg NDIS_STATUS i wskazać typ danych dostarczonych dla identyfikatora GUID:
fNDIS_GUID_TO_OID
Wskazuje, że struktura NDIS_GUID mapuje identyfikator GUID na identyfikator OID.
fNDIS_GUID_TO_STATUS
Wskazuje, że struktura NDIS_GUID mapuje identyfikator GUID na ciąg NDIS_STATUS.
fNDIS_GUID_ANSI_STRING
Wskazuje, że dla identyfikatora GUID jest dostarczany ciąg ANSI zakończony wartością null.
fNDIS_GUID_UNICODE_STRING
Wskazuje, że dla identyfikatora GUID podano ciąg Unicode.
fNDIS_GUID_ARRAY
Wskazuje, że dla identyfikatora GUID jest dostarczana tablica elementów danych. Określony Rozmiar wskazuje długość każdego elementu danych w tablicy.
fNDIS_GUID_ALLOW_READ
Po ustawieniu wskazuje, że wszyscy użytkownicy mogą używać tego identyfikatora GUID do uzyskiwania informacji.
fNDIS_GUID_ALLOW_WRITE
Po ustawieniu wskazuje, że wszyscy użytkownicy mogą używać tego identyfikatora GUID do ustawiania informacji.
Uwaga Domyślnie niestandardowe identyfikatory GUID usługi WMI dostarczane przez sterownik miniportu są dostępne tylko dla użytkowników z uprawnieniami administratora. Użytkownik z uprawnieniami administratora może zawsze odczytywać lub zapisywać w niestandardowym identyfikatorze GUID, jeśli sterownik miniportu obsługuje operację odczytu lub zapisu dla tego identyfikatora GUID. Ustaw flagi fNDIS_GUID_ALLOW_READ i fNDIS_GUID_ALLOW_WRITE, aby umożliwić wszystkim użytkownikom dostęp do niestandardowego identyfikatora GUID.
Należy pamiętać, że wszystkie niestandardowe identyfikatory GUID zarejestrowane przez sterownik miniportu muszą ustawić fNDIS_GUID_TO_OID lub fNDIS_GUID_TO_STATUS (nigdy nie ustawiać obu). Wszystkie inne flagi mogą być łączone przy użyciu operatora OR zgodnie z obowiązującymi przepisami.
W poniższym przykładzie struktura NDIS_GUID mapuje identyfikator 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};
Identyfikator GUID jest identyfikatorem używanym przez instrumentację zarządzania Windows (WMI) do uzyskiwania lub ustawiania informacji. NDIS przechwytuje identyfikator GUID wysyłany przez usługę WMI do sterownika NDIS, mapuje identyfikator GUID na identyfikator OID i wysyła identyfikator OID do sterownika. Sterownik zwraca elementy danych do usługi NDIS, która następnie zwraca dane do usługi WMI.
Usługa NDIS tłumaczy również zmiany stanu karty sieciowej na identyfikatory GUID rozpoznawane przez usługę WMI. Gdy sterownik miniportu zgłasza zmianę stanu karty sieciowej przy użyciu NdisMIndicateStatusEx funkcji, usługa NDIS tłumaczy NDIS_STATUS wskazywane przez sterownik miniportu na identyfikator GUID, który NDIS wysyła do usługi WMI.
Jeśli sterownik miniportu obsługuje identyfikatory GUID celnych, musi obsługiwać OID_GEN_SUPPORTED_GUIDS. Ten identyfikator OID powraca do NDIS mapowania niestandardowych identyfikatorów GUID na niestandardowe identyfikatory OID lub ciągi NDIS_STATUS. Po wykonaniu zapytania o sterownik miniportu przy użyciu OID_GEN_SUPPORTED_GUIDS usługa NDIS rejestruje niestandardowe identyfikatory GUID sterownika miniportu w usłudze WMI.
Wymagania
Nagłówek |
Ntddndis.h (m.in. Ndis.h) |