StreamClassReadWriteConfig-Funktion (strmini.h)

Artikel
02/07/2025

Die StreamClassReadWriteConfig Routine liest oder schreibt Konfigurationsdaten für den übergeordneten Bustreiber des Minidrivers.

Syntax

BOOLEAN STREAMAPI StreamClassReadWriteConfig(
  [in]      PVOID   HwDeviceExtension,
  [in]      BOOLEAN Read,
  [in, out] PVOID   Buffer,
  [in]      ULONG   Offset,
  [in]      ULONG   Length
);

Parameter

[in] HwDeviceExtension

Zeiger auf die Geräteerweiterung des Minidrivers. Der Minidriver gibt die Größe dieses Puffers in der HW_INITIALIZATION_DATA Struktur an, die er übergibt, wenn er sich über StreamClassRegisterMinidriverregistriert. Der Klassentreiber übergibt dann Zeiger an den Puffer in der HwDeviceExtension Member des HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXTund PORT_CONFIGURATION_INFORMATION Strukturen, die an den Minidriver übergeben werden.

[in] Read

Gibt an, ob die Konfigurationsinformationen gelesen oder geschrieben werden sollen. Ein Wert von TRUE gibt an, dass ein Lesevorgang angefordert wird. Der Wert FALSE- gibt an, dass ein Schreibvorgang ausgeführt werden soll.

[in, out] Buffer

Verweist auf den Puffer, der zum Lesen/Schreiben der Konfigurationsinformationen verwendet werden soll.

[in] Offset

Gibt den Offset innerhalb der Konfigurationsinformationen an, um den Lese-/Schreibvorgang zu starten.

[in] Length

Gibt die Länge der zu lesenden oder zu schreibenden Daten an.

Rückgabewert

Gibt TRUE bei Erfolg zurück, FALSE bei Fehlern.

Bemerkungen

Diese Routine liest oder schreibt Konfigurationsinformationen für den übergeordneten Bustreiber des Minidrivers. Bei einem PCI-Gerät liest StreamClassReadWriteConfig z. B. PCI-Konfigurationsinformationen vor oder schreibt diese.

Diese Routine kann nur bei PASSIVE_LEVEL aufgerufen werden.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	strmini.h (einschließlich Strmini.h)
Library	Stream.lib

Freigeben über