NdisCoOidRequestComplete-Funktion (ndis.h)
Die NdisCoOidRequestComplete--Funktion gibt den endgültigen Status einer OID-Anforderung zurück, für die die ProtocolCoOidRequest-Funktion eines CoNDIS-Clients oder eines eigenständigen Anrufmanagers zuvor NDIS_STATUS_PENDING zurückgegeben wurde.
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
Eine Adressfamilie (AF), die NDIS an den Client oder die eigenständige Anrufverwaltung übergeben hat ProtocolCoOidRequest Funktion.
[in, optional] NdisVcHandle
Eine virtuelle Verbindung (VC), die NDIS an die ProtocolCoOidRequest--Funktion des Client- oder eigenständigen Anrufmanagers übergeben hat. Ein NULL- Wert für diesen Parameter gibt an, dass die Anforderung nicht VC-spezifisch ist. Dieser Parameter ist NULL-, wenn der Aufrufer des NdisCoOidRequest oder NdisMCmOidRequest-Funktion ein NULL- VC-Handle angegeben hat.
[in, optional] NdisPartyHandle
Ein Parteihandle, das NDIS an die ProtocolCoOidRequest- funktion des Client- oder eigenständigen Anrufmanagers übergeben hat. Ein NULL- Wert für diesen Parameter gibt an, dass die Anforderung nicht parteispezifisch ist. Dieser Parameter ist NULL-, wenn der Aufrufer des NdisCoOidRequest- oder NdisMCmOidRequest Funktion ein NULL- Partyhandle angegeben hat.
[in] OidRequest
Ein Zeiger auf einen Puffer, der als NDIS_OID_REQUEST Struktur formatiert ist. Der Aufrufer der NdisCoOidRequest oder NdisMCmOidRequest Funktion, die diesen Puffer bereitgestellt hat.
[in] Status
Der endgültige Status des Anforderungsvorgangs, entweder NDIS_STATUS_SUCCESS oder eines treiberbestimmten NDIS_STATUS_XXX- Statuswerts außer NDIS_STATUS_PENDING.
Rückgabewert
Nichts
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 NdisCoOidRequestCompleteaufgerufen hat, ruft NDIS die ProtocolCoOidRequestComplete Funktion des Treibers, der ursprünglich die NdisCoOidRequest oder NdisMCmOidRequest Funktion aufgerufen hat.
Nur Clients und eigenständige Anrufmanager, die sich selbst bei NDIS als Protokolltreiber registrieren, können NdisCoOidRequestCompleteaufrufen. Miniport-Anrufmanager (MCMs) rufen die NdisMCmOidRequestComplete-Funktion oder NdisMCoOidRequestComplete stattdessen, je nachdem, ob die ProtocolCoOidRequest oder MiniportCoOidRequest Funktion des MCM-Treibers verarbeitet wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
| Zielplattform- | Desktop |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Connection_Function(ndis) |