Freigeben über

ALLOCATE_SHARED_MEMORY_HANDLER Rückruffunktion (ndis.h)

Die NetAllocateSharedMemory-Funktion (ALLOCATE_SHARED_MEMORY_HANDLER Einstiegspunkt) wird von NDIS aufgerufen, wenn ein Treiber gemeinsam genutzten Speicher von einem anbieter für gemeinsam genutzten Speicher zuweist.

Syntax

ALLOCATE_SHARED_MEMORY_HANDLER AllocateSharedMemoryHandler;

NDIS_STATUS AllocateSharedMemoryHandler(
  [in]      NDIS_HANDLE ProviderContext,
  [in]      PNDIS_SHARED_MEMORY_PARAMETERS SharedMemoryParameters,
  [in, out] PNDIS_HANDLE pSharedMemoryProviderContext
)
{...}

Parameter

[in] ProviderContext

Ein NDIS_HANDLE zu einem Block der vom Treiber zugewiesenen Kontextinformationen, die den Anbieter identifizieren. Der Anbieter hat diese Informationen im ProviderContext Mitglied des NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS Struktur.

[in] SharedMemoryParameters

Ein Zeiger auf einen NDIS_SHARED_MEMORY_PARAMETERS Struktur, die die angeforderten Attribute für den freigegebenen Speicher definiert.

[in, out] pSharedMemoryProviderContext

Ein Zeiger auf ein Handle für einen freigegebenen Speicherkontextbereich. Der Anbieter für gemeinsam genutzten Speicher stellt ein Handle bereit, mit dem der freigegebene Speicher identifiziert wird, den er zugewiesen hat.

Rückgabewert

NetAllocateSharedMemory können die folgenden Statuswerte zurückgeben:

Rückgabecode Beschreibung
NDIS_STATUS_SUCCESS
 Der Vorgang wurde erfolgreich abgeschlossen.
NDIS_STATUS_RESOURCES
 Fehler des Vorgangs, da nicht genügend Ressourcen zum Abschließen des Vorgangs vorhanden waren.
NDIS_STATUS_INVALID_PARAMETER
 Fehler beim Vorgang aufgrund eines ungültigen Eingabeparameters.
NDIS_STATUS_FAILURE
 Der Vorgang ist aus nicht angegebenen Gründen fehlgeschlagen.

Bemerkungen

NDIS ruft die NetAllocateSharedMemory Funktion eines anbieters gemeinsam genutzten Speichers auf, wenn ein Treiber die NdisAllocateSharedMemory Funktion.

Der Anbieter für gemeinsam genutzten Speicher hat den Einstiegspunkt (ALLOCATE_SHARED_MEMORY_HANDLER) für NetAllocateSharedMemory- im NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS Struktur.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Unterstützt in NDIS 6.20 und höher.
Zielplattform- Desktop
Header- ndis.h (include Ndis.h)
IRQL- PASSIVE_LEVEL

Siehe auch

NDIS_SHARED_MEMORY_PARAMETERS

NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS

NdisAllocateSharedMemory

  • Last updated on