StorPortRegistryReadAdapterKey-Funktion (storport.h)

Artikel
03/05/2024

Die StorPortRegistryReadAdapterKey-Routine wird vom Miniporttreiber aufgerufen, um die Hardware- oder Geräteregistrierungsadapterschlüssel zu lesen, die sich in der Registrierung unter HKLM/CurrentControlSet/Enum/Instance path/DeviceParameters/... Diese Schlüssel werden im Abschnitt INF DDInstall.HW ausgelesen.

Syntax

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

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Hardwaregeräteerweiterung. Dies ist ein HBA-Speicherbereich, den der Porttreiber im Namen des Miniporttreibers zuordnet und initialisiert. Miniport-Treiber speichern in dieser Erweiterung in der Regel HBA-spezifische Informationen, z. B. den Status des HBA und die zugeordneten Zugriffsbereiche für den HBA. Dieser Bereich steht dem Miniporttreiber unmittelbar nach dem Aufrufen von StorPortInitialize durch den Miniporttreiber zur Verfügung. Der Porttreiber gibt diesen Arbeitsspeicher frei, wenn er 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.

type	Bedeutung
REG_SZ	Unicode-Zeichenfolge mit Nullen.
REG_EXPAND_SZ	Unicode-Zeichenfolge mit Null-Termin mit Verweisen auf Umgebungsvariablen.
REG_BINARY	Binärdaten.
REG_DWORD	32-Bit-Doppelwort.
REG_DWORD_LITTLE_ENDIAN	32-Bit-Doppelwort mit einem Little-Endian-Format.
REG_DWORD_BIG_ENDIAN	32-Bit-Doppelwort mit einem Big-Endian-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-Quadlet-Zahl.
REG_QWORD_LITTLE_ENDIAN	64-Bit-Quadlet-Zahl mit einem Little-Endian-Format.

[in, out] ValueData

Zeiger auf die Daten, die die zu lesenden Registrierungsdaten enthalten. Die Daten werden aus UNICODE in eine MIT NULL endende ASCII-Zeichenfolge konvertiert.

[in, out] ValueDataLength

Gibt die Größe der Daten an, auf die valueData verweist.

Rückgabewert

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

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	storport.h (Storport.h einschließen)
Bibliothek	Storport.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

StorPortInitialize

Freigeben über