Udostępnij przez

OID_GEN_CO_SUPPORTED_GUIDS

Identyfikator OID OID_GEN_CO_SUPPORTED_GUIDS żąda sterownika miniportu, aby zwrócić tablicę struktur typu NDIS_GUID. 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 NdisMCoIndicateStatusEx.

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
Niestandardowy identyfikator GUID zdefiniowany dla sterownika miniportu.

Oid
Niestandardowy identyfikator OID, do którego mapuje identyfikator GUID.

stanu
NDIS_STATUS, do którego mapuje identyfikator GUID.

rozmiar
Po ustawieniu flagi fNDIS_GUID_ARRAY rozmiar określa rozmiar w bajtach każdego elementu danych w tablicy zwróconej 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.

flagi
Następujące flagi mogą być ze sobą ORed, 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
Po ustawieniu wskazuje, że struktura NDIS_GUID mapuje identyfikator GUID na identyfikator OID.

fNDIS_GUID_TO_STATUS
Po ustawieniu wskazuje, że struktura NDIS_GUID mapuje identyfikator GUID na ciąg NDIS_STATUS.

fNDIS_GUID_ANSI_STRING
Po ustawieniu wskazuje, że dla identyfikatora GUID jest dostarczany ciąg ANSI zakończony wartością null.

fNDIS_GUID_UNICODE_STRING
Po ustawieniu wskazuje, że ciąg Unicode jest dostarczany dla identyfikatora GUID.

fNDIS_GUID_ARRAY
Po ustawieniu 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ą wykonywać zapytania dotyczące tego identyfikatora GUID.

fNDIS_GUID_ALLOW_WRITE
Po ustawieniu wskazuje, że wszyscy użytkownicy mogą ustawić ten identyfikator GUID.

Uwagi

Nuta

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

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

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 z NdisMCoIndicateStatusEx, NDIS tłumaczy NDIS_STATUS wskazywany przez sterownik miniportu na identyfikator GUID, który NDIS wysyła do usługi WMI.

Jeśli sterownik miniportu zorientowany na połączenie obsługuje identyfikatory GUID celnych, musi obsługiwać OID_GEN_CO_SUPPORTED_GUIDS, który powraca do NDIS mapowania niestandardowych identyfikatorów GUID na niestandardowe identyfikatory OPERACYJNEGO lub parametry NDIS_STATUS. Po wykonaniu zapytania o sterownik miniportu za pomocą OID_GEN_CO_SUPPORTED_GUIDS usługa NDIS rejestruje niestandardowe identyfikatory GUID sterownika miniportu za pomocą usługi WMI.

Wymagania

version: Windows Vista and later Header: Ntddndis.h (include Ndis.h)

  • Last updated on