NdisMapFile-Funktion (ndis.h)

Artikel
02/27/2024

Die NdisMapFile-Funktion ordnet eine bereits geöffnete Datei einem Puffer zu, auf den der Aufrufer zugegriffen werden kann, wenn die Datei derzeit nicht zugeordnet ist.

Syntax

void NdisMapFile(
  [out] PNDIS_STATUS Status,
  [out] PVOID        *MappedBuffer,
  [in]  NDIS_HANDLE  FileHandle
);

Parameter

[out] Status

Ein Zeiger auf eine vom Aufrufer bereitgestellte Variable, in der diese Funktion den status des Zuordnungsvorgangs zurückgibt. Dies kann eine der folgenden Sein:

NDIS_STATUS_SUCCESS

Der Aufrufer hat exklusiven Zugriff auf den Dateiinhalt, bis die NdisUnmapFile-Funktion aufgerufen wird.

NDIS_STATUS_ALREADY_MAPPED

Der Aufrufer kann derzeit nicht auf den Dateiinhalt zugreifen.

[out] MappedBuffer

Ein Zeiger auf eine vom Aufrufer bereitgestellte Variable, in der diese Funktion die virtuelle Basisadresse des zugeordneten Dateiinhalts oder NULL zurückgibt.

[in] FileHandle

Das Handle, das von einem vorherigen Aufruf der NdisOpenFile-Funktion zurückgegeben wurde.

Rückgabewert

Keine

Bemerkungen

NdisMapFile ordnet einen virtuellen Adressbereich mit einer geöffneten Datei zu(n), damit der Treiber auf den Dateiinhalt zugreifen kann. Mit NdisMapFile kann jederzeit nur eine Zuordnung einer bestimmten Datei ausstehend sein. Folglich erhält ein erfolgreicher Aufrufer exklusiven Zugriff auf die Dateidaten, bis NdisUnmapFile oder die NdisCloseFile-Funktion aufgerufen wird.

Ein Miniporttreiber kann eine solche geöffnete Datei nach Bedarf zuordnen und die Zuordnung aufheben, indem er abwechselnd Aufrufe von NdisMapFile und NdisUnmapFile verwendet. Ein Aufruf von NdisCloseFile gibt fileHandle frei und hebt die Zuordnung des Puffers auf, der den Dateiinhalt enthält.

Ein Miniporttreiber kann NdisMapFile nur während der Initialisierung aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisMapFile (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisMapFile (NDIS 5.1)) in Windows XP.
Zielplattform	Universell
Header	ndis.h (Video.h einschließen)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_Miscellaneous_Function(ndis)