ALLOCATE_SHARED_MEMORY_HANDLER Rückruffunktion (ndis.h)

  • Artikel

Die NetAllocateSharedMemory-Funktion (ALLOCATE_SHARED_MEMORY_HANDLER Einstiegspunkt) wird von NDIS aufgerufen, wenn ein Treiber freigegebenen Arbeitsspeicher von einem Shared Memory-Anbieter zuordnet.

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 von vom Treiber zugewiesenen Kontextinformationen, die den Anbieter identifiziert. Der Anbieter hat diese Informationen im ProviderContext-Member des NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS Struktur.

[in] SharedMemoryParameters

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

[in, out] pSharedMemoryProviderContext

Ein Zeiger auf ein Handle für einen Shared Memory-Kontextbereich. Der Shared Memory-Anbieter stellt ein Handle bereit, das den freigegebenen Arbeitsspeicher identifiziert, den er zugeordnet hat.

Rückgabewert

NetAllocateSharedMemory kann die folgenden status-Werte zurückgeben:

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

Hinweise

NDIS ruft die NetAllocateSharedMemory-Funktion eines Anbieters für gemeinsam genutzten Speicher auf, wenn ein Treiber die NdisAllocateSharedMemory-Funktion .

Der Shared Memory-Anbieter hat den Einstiegspunkt (ALLOCATE_SHARED_MEMORY_HANDLER) für NetAllocateSharedMemory in der NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS Struktur.

Anforderungen

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

Weitere Informationen

NDIS_SHARED_MEMORY_PARAMETERS

NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS

NdisAllocateSharedMemory