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-Speicher-Karte 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

Zeiger auf den Kontext für die Schnittstellenroutine.

[in] HostBase

Gibt das zuzuordnende Fenster des physischen Arbeitsspeichers an. HostBase ist die Basisadresse für den Arbeitsspeicher Karte im physischen Adressraum des Systems.

[in] CardBase

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

[in] Enable

Gibt die Berechtigung für den Zugriff auf das Speicherfenster an. Wenn EnableTRUE ist, 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 zugewiesenen Ressourcen gewährt wird, nicht überschreiten. Wenn der Wert von Enable TRUE und der Wert von WindowSize 0 ist, wird die Größe des Speicherfensters verwendet, das dem Treiber in den zugewiesenen Ressourcen gewährt wird. Wenn EnableFALSE ist, wird WindowSize nicht verwendet.

[in, optional] AccessSpeed

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

[in, optional] BusWidth

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

  • PCMCIA_MEMORY_8BIT_ACCESS: Wenn EnableFALSE ist, wird BusWidth nicht verwendet.
  • PCMCIA_MEMORY_16BIT_ACCESS

[in, optional] IsAttributeMemory

Muss false für den allgemeinen 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 wurde, wie im Parameter Enable angegeben.

Hinweise

Ein Aufrufer muss den Context-Parameter auf den Kontext festlegen, der vom PCMCIA-Bustreiber angegeben wird. Der PCMCIA-Bustreiber gibt den Kontext für die Schnittstellenroutinen im Kontextelement derselben PCMCIA_INTERFACE_STANDARD-Struktur zurück, die die Zeiger auf die Schnittstellenroutinen enthält. Wenn der Context-Parameter ungültig ist, ist 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 Gesamtleistung des Systems zu gewährleisten, wird empfohlen, dass Treiber diese Routine bei IRQL < DISPATCH_LEVEL aufrufen.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile ntddpcm.h (include Ntddpcm.h)
IRQL <=DISPATCH_LEVEL (siehe Abschnitt Hinweise.)

Weitere Informationen