OID_GEN_NETWORK_LAYER_ADDRESSES
V sadě OID_GEN_NETWORK_LAYER_ADDRESSES identifikátor OID upozorní základní ovladač miniportu a další vrstvené ovladače o seznamu adres síťové vrstvy, které jsou přidružené k vázaným instancím.
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ý.
ovladače miniportu NDIS 5.1
Volitelný.
Poznámky
Vázaná instance je vazba mezi volajícím přenosem a ovladačem nastaveným voláním NdisOpenAdapterEx. Přenosy používají struktury TRANSPORT_ADDRESS a TA_ADDRESS k upozorňovat podkladové ovladače miniportu a další vrstvené ovladače o seznamu adres vrstvy sítě. Ovladače miniportu a další vrstvené ovladače používají kompatibilní NETWORK_ADDRESS_LIST a NETWORK_ADDRESS struktury definované následujícím způsobem k nastavení seznamu adres vrstvy sítě v vázaném rozhraní.
typedef struct _NETWORK_ADDRESS_LIST {
LONG AddressCount;
USHORT AddressType;
NETWORK_ADDRESS Address[1];
} NETWORK_ADDRESS_LIST, *PNETWORK_ADDRESS_LIST;
Členové této struktury obsahují následující informace:
AddressCount
Určuje počet adres síťové vrstvy uvedené v poli v Adresa člen.
AddressType
Určuje typ protokolu, který odesílá tento identifikátor OID. Tento člen je platný pouze v případě, že AddressCount člen je nastaven na nulu.
AddressCount člen je nastaven na nulu, aby oznámil ovladač miniportu nebo jiný vrstvený ovladač k vymazání seznamu adres síťové vrstvy v vázaném rozhraní. Protokol může být jedna z následujících hodnot:
NDIS_PROTOCOL_ID_DEFAULT
Výchozí protokol
NDIS_PROTOCOL_ID_TCP_IP
Protokol TCP/IP
NDIS_PROTOCOL_ID_IPX
Protokol NETWare IPX
NDIS_PROTOCOL_ID_NBF
Protokol NetBIOS
adresy
Pole adres typu NETWORK_ADDRESS síťové vrstvy.
AddressCount člen určuje počet prvků v tomto poli.
typedef struct _NETWORK_ADDRESS {
USHORT AddressLength;
USHORT AddressType;
UCHAR Address[1];
} NETWORK_ADDRESS, *PNETWORK_ADDRESS;
Členové této struktury obsahují následující informace:
AddressLength
Určuje velikost této adresy vrstvy sítě v bajtech.
Adresa člen obsahuje pole bajtů, které určují tuto adresu.
AddressType
Určuje typ protokolu, který odesílá tento identifikátor OID a tuto adresu síťové vrstvy. Tento člen je platný pouze v případě, že AddressCount člen ve struktuře NETWORK_ADDRESS_LIST je nastaven na nenulovou hodnotu.
AddressCount člen v NETWORK_ADDRESS_LIST je nastaven na nenulovou hodnotu, která oznámí ovladač miniportu nebo jiný vrstvený ovladač, aby změnil seznam adres vrstvy sítě v vázaném rozhraní. Typy protokolů jsou definovány v předchozím seznamu.
adresy
Pole bajtů, které určují tuto adresu síťové vrstvy.
AddressLength člen určuje počet bajtů v tomto poli.
Přenos může volat funkci NdisOidRequest a může předat NDIS_OID_REQUEST strukturu, která je vyplněna kódem OID_GEN_NETWORK_LAYER_ADDRESSES. Toto volání upozorní vázané instance změny v adresách přidružených k této instanci. V tomto volání přenos také předává vázané instance v NdisBindingHandle parametru. Vázaná instance je vazba nastavená mezi přenosem a podkladovým ovladačem miniportu nebo jiným vrstveným ovladačem. Pro toto volání by měla doprava vyplnit InformationBuffer člen NDIS_OID_REQUEST ukazatelem na strukturu TRANSPORT_ADDRESS. TRANSPORT_ADDRESS odpovídá struktuře NETWORK_ADDRESS_LIST a měla by obsahovat seznam adres síťové vrstvy.
Předpokládejme, že přenos předává adresy přes zprostředkující ovladač dolů na podkladový ovladač miniportu. Pokud zprostředkující ovladač také vyžaduje adresy, měl by si je před předáním do základního miniportového ovladače poznamenat. Základní miniportový ovladač, zejména starý ovladač, může vrátit hodnotu stavu NDIS_STATUS_NOT_SUPPORTED nebo NDIS_STATUS_SUCCESS. Základní miniportový ovladač rozšíří stav operace zpět směrem k přepravě. Pokud zprostředkující ovladač musí dál přijímat oznámení o adresách a v případě potřeby by měl zprostředkující ovladač změnit stav na NDIS_STATUS_SUCCESS. V opačném případě může přenos interpretovat NDIS_STATUS_NOT_SUPPORTED jako označení, že základní ovladač miniportu nevyžaduje, aby problém s přenosem další aktualizace adresy. Pokud je vrácena NDIS_STATUS_SUCCESS, jsou přepravy povinny nadále informovat podkladové ovladače o jakýchkoli změnách přidružených adres, včetně přidání a odstranění adres.
Protokol může nastavit AddressCount člen TRANSPORT_ADDRESS na nulu, aby oznámil ovladač miniportu nebo jiný vrstvený ovladač, aby vymazal seznam adres vrstvy sítě v vázaném rozhraní. Pokud je AddressCount nastavena na nulu, AddressType člen v NETWORK_ADDRESS_LIST je platný a AddressType členy ve strukturách NETWORK_ADDRESS nejsou platné. Na druhé straně může protokol nastavit AddressCount na nenulovou hodnotu, aby oznámil ovladač miniportu nebo jiný vrstvený ovladač, aby změnil seznam adres vrstvy sítě v vázaném rozhraní. V tomto případě není AddressType člen v NETWORK_ADDRESS_LIST platný a členy AddressType ve strukturách NETWORK_ADDRESS jsou platné.
Požadavky
Záhlaví |
Ntddndis.h (včetně Ndis.h) |