Freigeben über

PCMCIA_MODIFY_MEMORY_WINDOW Rückruffunktion (ntddpcm.h)

  • Artikel

Die PCMCIA_MODIFY_MEMORY_WINDOW Schnittstellenroutine legt die Attribute eines Speicherfensters für eine PCMCIA-Speicherkarte fest. Das Speicherfenster wird vom PCMCIA-Bustreiber zugeordnet.

Syntax

PCMCIA_MODIFY_MEMORY_WINDOW PcmciaModifyMemoryWindow;

BOOLEAN PcmciaModifyMemoryWindow(
  [in, optional] PVOID Context,
  [in]           ULONGLONG HostBase,
  [in]           ULONGLONG CardBase,
  [in]           BOOLEAN Enable,
  [in, optional] ULONG WindowSize,
  [in, optional] UCHAR AccessSpeed,
  [in, optional] UCHAR BusWidth,
  [in, optional] BOOLEAN IsAttributeMemory
)
{...}

Parameter

[in, optional] Context

Zeigen Sie auf den Kontext für die Schnittstellenroutine.

[in] HostBase

Gibt das physische Speicherfenster an, das zugeordnet werden soll. HostBase- ist die Basisadresse für die Speicherkarte im physischen Adressraum des Systems.

[in] CardBase

Gibt den Byteoffset im Speicher der PC-Karte oder cardBus-Karte an, in dem die Speicherzuordnung beginnt.

[in] Enable

Gibt die Berechtigung für den Zugriff auf das Speicherfenster an. Wenn EnableTRUEist, ist der Speicherzugriff zulässig, andernfalls ist der Speicherzugriff nicht zulässig.

[in, optional] WindowSize

Gibt die Größe des zugeordneten Speicherfensters in Bytes an. Der Wert von WindowSize darf das speicherfenster, das dem Treiber in den zugeordneten Ressourcen gewährt wird, nicht überschreiten. Wenn der Wert "Enable" TRUE ist und der Wert von WindowSize null ist, wird die Größe des Speicherfensters verwendet, das dem Treiber in den zugewiesenen Ressourcen gewährt wird. Wenn EnableFALSEist, wird WindowSize nicht verwendet.

[in, optional] AccessSpeed

Gibt die Zugriffsgeschwindigkeit der PC-Karte oder CardBus-Karte an. Der Wert AccessSpeed- wird gemäß der PC Card Standard, Release 6.1, codiert. Wenn "Enable" FALSE-ist, wird AccessSpeed- nicht verwendet.

[in, optional] BusWidth

Gibt die Breite des Buszugriffs auf die PCMCIA-Speicherkarte an. BusWidth- muss einer der folgenden Werte sein:

  • PCMCIA_MEMORY_8BIT_ACCESS: Wenn EnableFALSEist, wird BusWidth- nicht verwendet.
  • PCMCIA_MEMORY_16BIT_ACCESS

[in, optional] IsAttributeMemory

Muss FALSE- für gemeinsame Arbeitsspeicher und TRUE- für den Attributspeicher sein.

Rückgabewert

Die PCMCIA_MODIFY_MEMORY_WINDOW Schnittstellenroutine gibt TRUE zurück, wenn das Speicherfenster erfolgreich aktiviert oder deaktiviert ist, wie durch den Parameter Enable angegeben.

Bemerkungen

Ein Aufrufer muss den parameter Context auf den Kontext festlegen, der vom PCMCIA-Bustreiber angegeben wird. Der PCMCIA-Bustreiber gibt den Kontext für die Schnittstellenroutinen im Context Member derselben PCMCIA_INTERFACE_STANDARD Struktur zurück, die die Zeiger auf die Schnittstellenroutinen enthält. Wenn der parameter Context ungültig ist, wird das Systemverhalten nicht definiert, und das System wird möglicherweise angehalten.

Aufrufer dieser Routine müssen unter IRQL <= DISPATCH_LEVEL ausgeführt werden. Um die Gesamtsystemleistung aufrechtzuerhalten, empfiehlt es sich, diese Routine bei IRQL-< DISPATCH_LEVEL aufzurufen.

Anforderungen

Anforderung Wert
Zielplattform- Desktop
Header- ntddpcm.h (include Ntddpcm.h)
IRQL- <=DISPATCH_LEVEL (Siehe Abschnitt "Hinweise").)

Siehe auch