Sdílet prostřednictvím


OID_SWITCH_NIC_DELETE

Hrana protokolu Hyper-V rozšiřitelného přepínače vydává požadavek na sadu identifikátorů objektu (OID) OID_SWITCH_NIC_DELETE do zásobníku rozšiřitelného ovladače přepínače. Tento požadavek OID upozorní základní rozšíření rozšiřitelných přepínačů o odstranění připojení mezi rozšiřitelným přepínačem a síťovým adaptérem. Hrana protokolu rozšiřitelného přepínače dříve upozorňována rozšíření, že toto připojení je odstraněno, když vydala požadavek sady identifikátorů OID_SWITCH_NIC_DISCONNECT.

InformationBuffer člen struktury NDIS_OID_REQUEST obsahuje ukazatel na NDIS_SWITCH_NIC_PARAMETERS strukturu.

Poznámky

PortId člen struktury NDIS_SWITCH_NIC_PARAMETERS určuje port, pro který se provádí oznámení o odstranění. Rozšíření rozšiřitelného přepínače může získat informace o parametrech pro tento a další porty na rozšiřitelném přepínači vydáním požadavků dotazu OID OID_SWITCH_PORT_ARRAY.

Index člen struktury NDIS_SWITCH_NIC_PARAMETERS určuje index síťového adaptéru, pro který se provádí oznámení o odstranění. Síťový adaptér se zadaným hodnotou indexu je připojený k rozšiřitelnému portu přepínače určenému PortId členu. Další informace o těchto hodnotách indexu naleznete v tématu hodnoty indexu síťových adaptérů.

Než hrana protokolu rozšiřitelného přepínače vydá požadavek OID_SWITCH_NIC_DELETE, zaručuje, že byly dokončeny všechny požadavky čekající na odeslání nebo přijetí paketů pro zadané připojení síťového adaptéru. Hrana protokolu také zaručuje, že byly dokončeny všechny čekající požadavky OID pro připojení adaptéru a rozšiřitelné referenční čítače přepínače pro připojení adaptéru mají nulovou hodnotu.

Poznámka Pokud rozšíření zvýší referenční čítač rozšiřitelného přepínače pro síťový adaptér voláním ReferenceSwitchNic, požadavek OID_SWITCH_NIC_DELETE nevystaví, zatímco referenční čítač není nenulový. Rozšíření dekrementuje rozšiřitelný referenční čítač přepínače voláním DereferenceSwitchNic.

Toto rozšíření musí dodržovat tyto pokyny pro zpracování požadavků sady identifikátorů identifikátorů OID_SWITCH_NIC_DELETE:

  • Rozšíření nesmí upravovat strukturu NDIS_SWITCH_NIC_PARAMETERS, která je přidružená k požadavku OID.

  • Toto rozšíření musí vždy předat tento požadavek sady identifikátorů na podkladová rozšíření. Rozšíření nesmí požadavek dokončit.

  • Rozšíření nesmí vydávat vlastní požadavky sady identifikátorů OID_SWITCH_NIC_DELETE.

  • Rozšiřitelný přepínač externího síťového adaptéru může svázat s jedním nebo více podkladovými fyzickými adaptéry. U každého fyzického síťového adaptéru vázaného na externí síťový adaptér vydá hrana protokolu rozšiřitelného přepínače samostatný požadavek sady identifikátorů OID_SWITCH_NIC_DELETE. Každý požadavek sady identifikátorů určuje jinou hodnotu indexu připojení síťového adaptéru. Další informace o těchto hodnotách indexu naleznete v tématu hodnoty indexu síťových adaptérů.

    Rozšíření musí udržovat stav připojení pro každý základní fyzický adaptér. Další informace o různých konfiguracích, ve kterých mohou být fyzické síťové adaptéry svázány s externím síťovým adaptérem, najdete v tématu Typy konfigurací fyzických síťových adaptérů.

Další informace o stavech rozšiřitelných portů přepínačů a připojení síťových adaptérů naleznete v tématu Hyper-V Rozšiřitelný přepínač a stavy síťových adaptérů.

Návratové stavové kódy

Základní miniportový okraj rozšiřitelného přepínače dokončí požadavek dotazu OID OID_SWITCH_NIC_DELETE a vrátí následující stavový kód.

Stavový kód Popis

NDIS_STATUS_SUCCESS

Požadavek OID byl úspěšně dokončen.

Požadavky

Verze

Podporováno v NDIS 6.30 a novějších verzích.

Záhlaví

Ntddndis.h (včetně Ndis.h)

Viz také


DereferenceSwitchNic

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DISCONNECT

OID_SWITCH_PORT_ARRAY

ReferenceSwitchNic