NdisMapFile-Funktion (ndis.h)
Die NdisMapFile--Funktion ordnet eine bereits geöffnete Datei einem Aufruferpuffer zu, 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, der eine der folgenden Sein kann:
NDIS_STATUS_SUCCESS
Der Aufrufer hat exklusiven Zugriff auf den Dateiinhalt, bis die NdisUnmapFile--Funktion aufgerufen wird.
NDIS_STATUS_ALREADY_MAPPED
Der Aufrufer kann zurzeit 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
Nichts
Bemerkungen
NdisMapFile einem virtuellen Adressbereich eine geöffnete Datei zuordnet (karten), sodass der Treiber auf den Dateiinhalt zugreifen kann. NdisMapFile- ermöglicht nur eine Zuordnung einer bestimmten Datei jederzeit ausstehend. Folglich erhält ein erfolgreicher Aufrufer exklusiven Zugriff auf die Dateidaten, bis NdisUnmapFile- oder die NdisCloseFile-Funktion aufgerufen wird.
Ein Miniporttreiber kann eine so geöffnete Datei nach Bedarf zuordnen und aufheben, indem abwechselnde Aufrufe von NdisMapFile- und NdisUnmapFile-. Ein Aufruf von NdisCloseFile gibt die FileHandle- frei und gibt den Puffer ab, der den Dateiinhalt enthält.
Ein Miniporttreiber kann NdisMapFile- nur während der Initialisierung aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte 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- | Universal |
| Header- | ndis.h (include Video.h) |
| Library | Ndis.lib |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Miscellaneous_Function(ndis) |