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
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) |