StorPortRegistryWriteAdapterKey-Funktion (storport.h)

Artikel
02/07/2025

Die StorPortRegistryReadAdapterKey Routine wird vom Miniporttreiber aufgerufen, um die Hardware- oder Geräteregistrierungsadapterschlüssel in der Registrierung unter HKLM/CurrentControlSet/Enum/Instanzpfad/DeviceParameters/... Diese Schlüssel werden im abschnitt INF DDInstall.HW Sectiongelesen.

Syntax

ULONG StorPortRegistryWriteAdapterKey(
  [in]           PVOID  HwDeviceExtension,
  [in, optional] PUCHAR SubKeyName,
  [in]           PUCHAR ValueName,
  [in]           ULONG  ValueType,
  [in, out]      PVOID  ValueData,
  [in, out]      ULONG  ValueDataLength
);

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Hardwaregeräteerweiterung. Dies ist ein HBA-Speicherbereich, den der Porttreiber im Namen des Miniporttreibers zuweist und initialisiert. Miniporttreiber speichern in der Regel HBA-spezifische Informationen in dieser Erweiterung, z. B. den Zustand der HBA und die zugeordneten Zugriffsbereiche für die HBA. Dieser Bereich steht dem Miniporttreiber unmittelbar nach dem Aufruf des Miniporttreibers StorPortInitializezur Verfügung. Der Porttreiber gibt diesen Speicher frei, wenn es das Gerät entfernt. Der Miniporttreiber muss bei IRQL-PASSIVE_LEVEL ausgeführt werden, wenn er diese Routine aufruft.

[in, optional] SubKeyName

Der Miniport-Unterschlüssel.

[in] ValueName

Der Name des Werts unter dem Schlüssel.

[in] ValueType

Einer der folgenden Registrierungsdatentypen.

Art	Bedeutung
REG_SZ	Unicode-Zeichenfolge mit Null-Beendigung.
REG_EXPAND_SZ	Unicode-Zeichenfolge mit Null-gekündigter Zeichenfolge mit Umgebungsvariablenverweisen.
REG_BINARY	Binäre Daten.
REG_DWORD	32-Bit-Doppelwort.
REG_DWORD_LITTLE_ENDIAN	32-Bit-Doppelwort mit einem kleinen Endian-Format.
REG_DWORD_BIG_ENDIAN	32-Bit-Doppelwort mit einem Big-End-Format.
REG_LINK	Unicode-Zeichenfolge, die eine symbolische Verknüpfung angibt.
REG_MULTI_SZ	Mehrere Unicode-Zeichenfolgen.
REG_RESOURCE_LIST	Ressourcenliste in der Ressourcenzuordnung.
REG_FULL_RESOURCE_DESCRIPTOR	Ressourcenliste in der Hardwarebeschreibung.
REG_RESOURCE_REQUIREMENTS_LIST	Ressourcenanforderungsliste.
REG_QWORD	64-Bit-Quadletnummer.
REG_QWORD_LITTLE_ENDIAN	64-Bit-Quadletnummer mit einem kleinen Endenformat.

[in, out] ValueData

Zeigen Sie auf die Daten, die die zu lesenden Registrierungsdaten enthalten. Die Daten werden von UNICODE in eine MIT NULL beendete ASCII-Zeichenfolge konvertiert.

[in, out] ValueDataLength

Gibt die Größe der Daten an, auf die durch ValueData-verwiesen wird.

Rückgabewert

Gibt STOR_STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist, andernfalls der entsprechende Fehlercode.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	storport.h (include Storport.h)
Library	Storport.lib
IRQL-	PASSIVE_LEVEL

Siehe auch

StorPortInitialize

Freigeben über