NdisAllocateCloneOidRequest-Funktion (ndis.h)

  • Artikel

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_STATUS_SUCCESS
 NDIS hat eine NDIS_OID_REQUEST-Struktur erfolgreich zugeordnet. Der CloneRequest-Parameter enthält einen Zeiger auf die NDIS_OID_REQUEST-Struktur.
NDIS_STATUS_INVALID_PARAMETER
 Fehler bei der Zuordnungsanforderung, da das unter SourceHandle angegebene NDIS-Handle ungültig ist.
NDIS_STATUS_RESOURCES
 Fehler bei der Zuordnungsanforderung, da NDIS nicht über ausreichende Ressourcen zum Abschließen der Zuordnungsanforderung verfügte.
NDIS_STATUS_FAILURE
 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)

Weitere Informationen

NDIS_OID_REQUEST

NdisFreeCloneOidRequest