Festlegen eines Paket-Koalescing-Empfangsfilters
Um einen Empfangsfilter auf einen Miniporttreiber herunterzuladen und festzulegen, der paketverknen unterstützt, gibt ein überladender Treiber eine OID-Methodenanforderung von OID_RECEIVE_FILTER_SET_FILTER aus. Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur für die OID-Anforderung enthält einen Zeiger auf einen vom Aufrufer zugewiesenen Puffer. Dieser Puffer ist so formatiert, dass er Folgendes enthält:
Eine NDIS_RECEIVE_FILTER_PARAMETERS-Struktur , die die Parameter für einen NDIS-Empfangsfilter angibt.
Ein Array von NDIS_RECEIVE_FILTER_FIELD_PARAMETERS Strukturen, das das Filtertestkriterium für ein Feld in einem Netzwerkpaketheader angibt.
Weitere Informationen dazu, wie ein übersteigender Treiber die Parameter für ein paketverknendes Empfangsfilter angibt, finden Sie unter Angeben eines Paket-Koalescing-Empfangsfilters.
Wenn NDIS eine OID-Anforderung zum Festlegen eines Empfangsfilters für den zugrunde liegenden Netzwerkadapter empfängt, überprüft es die Empfangsfilterparameter. Wenn der überlastende Treiber einen neuen Empfangsfilter angibt, generiert NDIS auch einen eindeutigen Filterbezeichner (ID) für den Empfangsfilter.
Nachdem NDIS die erforderlichen Ressourcen und die Filter-ID zugewiesen hat, leitet es die OID-Anforderung an den Miniporttreiber weiter. Wenn der Miniporttreiber die erforderlichen Software- und Hardwareressourcen für den Empfangsfilter erfolgreich zuordnen kann, schließt der Miniporttreiber die OID-Anforderung mit einer status NDIS_STATUS_SUCCESS ab.
Nach erfolgreicher Rückgabe der OID-Methodenanforderung von OID_RECEIVE_FILTER_SET_FILTER enthält das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine NDIS_RECEIVE_FILTER_PARAMETERS-Struktur . Diese Struktur wird von NDIS mit der neuen Filter-ID aktualisiert.