NdisAllocateCloneOidRequest-Funktion (ndis.h)
Die NdisAllocateCloneOidRequest-Funktion weist Arbeitsspeicher für eine neue NDIS_OID_REQUEST-Struktur zu und kopiert alle Informationen aus einer vorhandenen NDIS_OID_REQUEST-Struktur in die neu zugewiesene Struktur.
Syntax
NDIS_STATUS NdisAllocateCloneOidRequest(
[in] IN NDIS_HANDLE SourceHandle,
IN PNDIS_OID_REQUEST OidRequest,
[in] IN UINT PoolTag,
OUT PNDIS_OID_REQUEST *ClonedOidRequest
);
Parameter
[in] SourceHandle
Ein NDIS-Handle, das ein Filtermodul oder die Protokollbindung eines zwischengeschalteten Treibers identifiziert.
OidRequest
Ein Zeiger auf eine vorhandene NDIS_OID_REQUEST-Struktur , aus der NDIS die Informationen in die neu zugeordnete Struktur kopiert.
[in] PoolTag
Ein Kernelpooltag. Das Tag ist eine Zeichenfolge, die durch einzelne Anführungszeichen getrennt ist, mit bis zu vier Zeichen, die normalerweise in umgekehrter Reihenfolge angegeben werden.
ClonedOidRequest
Ein Zeiger auf einen Zeiger auf eine NDIS_OID_REQUEST Struktur. Wenn NDIS NDIS_STATUS_SUCCESS zurückgibt, stellt NDIS einen Zeiger auf die neue, geklonte NDIS_OID_REQUEST-Struktur bereit. andernfalls legt NDIS den Zeigerwert auf NULL fest.
Rückgabewert
NdisAllocateClonedRequest kann einen der folgenden status-Werte zurückgeben:
| Rückgabecode | Beschreibung |
|---|---|
|
NDIS hat eine NDIS_OID_REQUEST-Struktur erfolgreich zugeordnet. Der CloneRequest-Parameter enthält einen Zeiger auf die NDIS_OID_REQUEST-Struktur. |
|
Fehler bei der Zuordnungsanforderung, da das unter SourceHandle angegebene NDIS-Handle ungültig ist. |
|
Fehler bei der Zuordnungsanforderung, da NDIS nicht über ausreichende Ressourcen zum Abschließen der Zuordnungsanforderung verfügte. |
|
Der Treiber konnte die geklonte Struktur nicht aus anderen Gründen als aus der vorherigen Liste zuordnen. |
Hinweise
Um eine Anforderung an die zugrunde liegenden Treiber weiterzuleiten, muss ein NDIS-Zwischentreiber oder Filtertreiber NdisAllocateCloneOidRequest aufrufen, um eine geklonte NDIS_OID_REQUEST Struktur zuzuweisen. Ein Filtertreiber oder Zwischentreiber sollte die ursprüngliche NDIS_OID_REQUEST-Struktur nicht an zugrunde liegende Treiber weiterleiten.
NdisAllocateCloneOidRequest weist neuen Arbeitsspeicher zu und kopiert die Daten aus einer vorhandenen NDIS_OID_REQUEST-Struktur in die neue Struktur.
Der Treiber muss anschließend die NdisFreeCloneOidRequest-Funktion aufrufen, um die NDIS_OID_REQUEST-Struktur freizusetzen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt in NDIS 6.0 und höher. |
| Zielplattform | Desktop |
| Kopfzeile | ndis.h (einschließlich Ndis.h) |
| Bibliothek | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_OID_Function(ndis) |