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