StorPortRegistryWrite-Funktion (storport.h)
Die StorPortRegistryWrite Routine wird vom Miniporttreiber aufgerufen, um die Registrierungsdaten in einem angegebenen Puffer aus ASCII in Unicode zu konvertieren und dann die Daten in den Speicherbereich des Miniporttreibers zu schreiben.
Syntax
STORPORT_API BOOLEAN StorPortRegistryWrite(
[in] PVOID HwDeviceExtension,
[in] PUCHAR ValueName,
[in] ULONG Global,
[in] ULONG Type,
[in] PUCHAR Buffer,
[in] ULONG BufferLength
);
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 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] ValueName
Zeigen Sie auf eine Zeichenfolge, die den Wertnamen angibt.
[in] Global
Gibt an, ob der Vorgang adapterspezifisch sein soll oder ob er sich auf alle Adapter beziehen soll.
[in] Type
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] Buffer
Zeigen Sie auf einen Puffer, der die zu schreibenden Registrierungsdaten enthält.
[in] BufferLength
Gibt die Größe des Puffers an, auf den Pufferverweist.
Rückgabewert
StorPortRegistryWrite gibt einen booleschen Wert von TRUE zurück, wenn die Registrierungsdaten erfolgreich konvertiert und geschrieben wurden; andernfalls gibt diese Routine FALSE-zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | storport.h (include Storport.h) |
| Library | Storport.lib |
| IRQL- | PASSIVE_LEVEL |
| DDI-Complianceregeln | StorPortIrql(storport) |