NdisCoOidRequestComplete-Funktion (ndis.h)

Artikel
03/01/2024

Die NdisCoOidRequestComplete-Funktion gibt den endgültigen status einer OID-Anforderung zurück, für die die ProtocolCoOidRequest-Funktion eines CoNDIS-Clients oder eigenständigen Aufruf-Managers zuvor NDIS_STATUS_PENDING zurückgegeben hat.

Syntax

void NdisCoOidRequestComplete(
  [in]           NDIS_HANDLE       NdisAfHandle,
  [in, optional] NDIS_HANDLE       NdisVcHandle,
  [in, optional] NDIS_HANDLE       NdisPartyHandle,
  [in]           PNDIS_OID_REQUEST OidRequest,
  [in]           NDIS_STATUS       Status
);

Parameter

[in] NdisAfHandle

Ein Adressfamilienhandle (AF), das NDIS an den Client oder den eigenständigen Anrufleiter übergeben wurde. ProtocolCoOidRequest-Funktion .

[in, optional] NdisVcHandle

Ein virtuelles Verbindungshandle (VC), das NDIS an die ProtocolCoOidRequest-Funktion des Client oder eigenständigen Aufruf-Managers übergeben wurde. Ein NULL-Wert für diesen Parameter gibt an, dass die Anforderung nicht VC-spezifisch ist. Dieser Parameter ist NULL , wenn der Aufrufer der NdisCoOidRequest - oder NdisMCmOidRequest-Funktion ein NULL-VC-Handle angegeben hat.

[in, optional] NdisPartyHandle

Ein Parteihandle, das NDIS an den Client oder die ProtocolCoOidRequest-Funktion des eigenständigen Aufruf-Managers übergeben wurde. Ein NULL-Wert für diesen Parameter gibt an, dass die Anforderung nicht parteispezifisch ist. Dieser Parameter ist NULL, wenn der Aufrufer der NdisCoOidRequest- oder NdisMCmOidRequest-Funktion ein NULL-Parteihandle angegeben hat.

[in] OidRequest

Ein Zeiger auf einen Puffer, der als NDIS_OID_REQUEST-Struktur formatiert ist. Der Aufrufer der NdisCoOidRequest- oder NdisMCmOidRequest-Funktion hat diesen Puffer bereitgestellt.

[in] Status

Die endgültige status des Anforderungsvorgangs, entweder NDIS_STATUS_SUCCESS oder ein vom Treiber ermittelter NDIS_STATUS_XXX-status-Wert außer NDIS_STATUS_PENDING.

Rückgabewert

Keine

Bemerkungen

Ein CoNDIS-Protokolltreiber, der NDIS_STATUS_PENDING aus seiner ProtocolCoOidRequest-Funktion zurückgibt, muss NdisCoOidRequestComplete aufrufen, nachdem der Protokolltreiber den Anforderungsvorgang abgeschlossen hat.

Nachdem ein Treiber NdisCoOidRequestComplete aufgerufen hat, ruft NDIS die ProtocolCoOidRequestComplete-Funktion des Treibers, der ursprünglich die Funktion NdisCoOidRequest oder NdisMCmOidRequest aufgerufen hat.

Nur Clients und eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, können NdisCoOidRequestComplete aufrufen. Miniport-Anrufmanager (MCMs) rufen auf NdisMCmOidRequestComplete-Funktion oder NdisMCoOidRequestComplete stattdessen , je nachdem, ob die ProtocolCoOidRequest - bzw . MiniportCoOidRequest-Funktion des MCM-Treibers die Anforderung des Clients verarbeitet hat.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Zielplattform	Desktop
Kopfzeile	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_Connection_Function(ndis)