OID_802_3_DELETE_MULTICAST_ADDRESS

Als Set-Anforderung verwenden NDIS- und overlying-Protokolltreiber die OID_802_3_DELETE_MULTICAST_ADDRESS OID, um eine zuvor hinzugefügte Multicastadresse aus der Multicastadressenliste eines Miniportadapters zu löschen. Die Multicastadresse ist ein Array von 6 Bytes. Durch das Löschen einer Adresse wird diese Adresse deaktiviert, sodass sie keine Multicastpakete mehr empfangen kann.

Versionsinformationen

Windows Vista
Unterstützt.

Miniporttreiber NDIS 6.0 und höher
Nicht angefordert.

Bemerkungen

Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält die 6-Byte-Adresse, die aus der Multicastadressenliste gelöscht werden soll.

Die OID_802_3_DELETE_MULTICAST_ADDRESS OID-Anforderung kann nur eine Adresse löschen. Um mehr als eine Adresse zu löschen, muss der Protokolltreiber mehrere OID_802_3_DELETE_MULTICAST_ADDRESS OID-Anforderungen ausgeben.

NDIS-Miniporttreiber erhalten diese OID-Anforderung nicht direkt. Stattdessen konsolidiert NDIS jede Sequenz von OID_802_3_ADD_MULTICAST_ADDRESS und OID_802_3_DELETE_MULTICAST_ADDRESS OID-Anforderungen in einer einzelnen OID_802_3_MULTICAST_LIST OID-Anforderung.

Um die gesamte Multicastliste zu ersetzen oder zu löschen, kann der Protokolltreiber die OID_802_3_MULTICAST_LIST OID-Anforderung verwenden.

Um der Liste eine Adresse hinzuzufügen, kann der Protokolltreiber die OID_802_3_ADD_MULTICAST_ADDRESS OID-Anforderung verwenden.

Der übergeordnete Protokolltreiber kann eine bestimmte Multicastadresse mehrmals hinzufügen, indem mehrere OID_802_3_ADD_MULTICAST_ADDRESS OID-Anforderungen gesendet werden. Wenn NDIS die erste Add-Anforderung für eine bestimmte Multicastadresse erfolgreich ist, wird NDIS alle nachfolgenden Add-Anforderungen für diese Adresse erfolgreich sein. Um eine Multicastadresse zu löschen, die mehr als einmal hinzugefügt wurde, muss der überlastende Treiber die Adresse so oft löschen, wie er die Adresse hinzugefügt hat.

Zurückgeben von status Codes

Die MiniportOidRequest-Funktion des Miniport-Treibers gibt einen der folgenden Werte für diese Anforderung zurück:

Begriff BESCHREIBUNG

NDIS_STATUS_SUCCESS

Der Miniporttreiber hat die Anforderung erfolgreich abgeschlossen.

NDIS_STATUS_PENDING

Der Miniporttreiber führt die Anforderung asynchron aus. Nachdem der Miniporttreiber alle Verarbeitungsschritte abgeschlossen hat, muss er die Anforderung erfolgreich ausführen, indem er die NdisMOidRequestComplete-Funktion aufruft und NDIS_STATUS_SUCCESS für den Parameter Status übergibt.

NDIS_STATUS_NOT_ACCEPTED

Der Miniporttreiber wird zurückgesetzt.

NDIS_STATUS_REQUEST_ABORTED

Der Miniporttreiber hat die Verarbeitung der Anforderung beendet. Beispielsweise hat NDIS die MiniportResetEx-Funktion aufgerufen.

Anforderungen

Header

Ntddndis.h (include Ndis.h)

Weitere Informationen

OID_802_3_ADD_MULTICAST_ADDRESS

OID_802_3_MAXIMUM_LIST_SIZE

OID_802_3_MULTICAST_LIST