StorPortRegistryWrite-Funktion (storport.h)
Die StorPortRegistryWrite-Routine wird vom Miniporttreiber aufgerufen, um die In einem angegebenen Puffer enthaltenen Registrierungsdaten von ASCII in Unicode zu konvertieren und die Daten dann in den Speicherbereich pro HBA 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. Hierbei handelt es sich um einen HBA-Speicherbereich, den der Porttreiber im Auftrag des Miniporttreibers ordnet und initialisiert. Miniporttreiber speichern normalerweise HBA-spezifische Informationen in dieser Erweiterung, z. B. den Zustand des HBA und die zugeordneten Zugriffsbereiche für den HBA. Dieser Bereich steht dem Miniporttreiber unmittelbar nach dem Aufruf des Miniporttreibers StorPortInitialize 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] ValueName
Zeiger auf eine Zeichenfolge, die den Wertnamen angibt.
[in] Global
Gibt an, ob der Vorgang adapterspezifisch sein soll oder ob er sich auf alle Adapter bezieht.
[in] Type
Einer der folgenden Registrierungsdatentypen.
| type | Bedeutung |
|---|---|
| REG_SZ | Unicode-Zeichenfolge mit Null-Endung. |
| REG_EXPAND_SZ | Unicode-Zeichenfolge mit Null-Termin mit Umgebungsvariablenbezügen. |
| 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-Quadletnummer. |
| REG_QWORD_LITTLE_ENDIAN | 64-Bit-Quadletnummer mit einem Little-Endian-Format. |
[in] Buffer
Zeiger auf einen Puffer, der die zu schreibenden Registrierungsdaten enthält.
[in] BufferLength
Gibt die Größe des Puffers an, auf den puffer verweist.
Rückgabewert
StorPortRegistryWrite gibt den booleschen Wert TRUE zurück, wenn die Registrierungsdaten erfolgreich konvertiert und geschrieben wurden. Andernfalls gibt diese Routine FALSE zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | storport.h (einschließlich Storport.h) |
| Bibliothek | Storport.lib |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | StorPortIrql(storport) |