Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die NdisAllocateCloneOidRequest-Funktion weist Speicher für eine neue NDIS_OID_REQUEST Struktur zu und kopiert alle Informationen aus einer vorhandenen NDIS_OID_REQUEST Struktur in die neu zugeordnete 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 Zwischentreibers 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 einfache Anführungszeichen getrennt ist und maximal vier Zeichen enthält, in der Regel in umgekehrter Reihenfolge angegeben.
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 Statuswerte zurückgeben:
| Rückgabecode | Beschreibung |
|---|---|
|
NDIS hat erfolgreich eine NDIS_OID_REQUEST Struktur zugewiesen. Der parameter CloneRequest enthält einen Zeiger auf die NDIS_OID_REQUEST Struktur. |
|
Fehler bei der Zuordnungsanforderung, da das bei 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 aus anderen Gründen als denen in der vorherigen Liste nicht zuordnen. |
Bemerkungen
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 neuen Speicher zuordnet 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 freizulegen.
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_OID_Function(ndis) |