StorPortAllocateRegistryBuffer-Funktion (storport.h)
Die StorPortAllocateRegistryBuffer Routine wird vom Miniporttreiber aufgerufen, um einen Puffer zuzuweisen, der zum Lesen und Schreiben von Registrierungsdaten verwendet werden kann.
Syntax
STORPORT_API PUCHAR StorPortAllocateRegistryBuffer(
[in] PVOID HwDeviceExtension,
[in] PULONG Length
);
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] Length
Zeigen Sie auf eine lange, die bei Eingabe die Länge in Byte des Registrierungspuffers angibt, den der Aufrufer benötigt. Bei der Ausgabe wird Length aktualisiert, um die tatsächliche Größe des zugeordneten Puffers widerzuspiegeln.
Rückgabewert
StorPortAllocateRegistryBuffer gibt einen Zeiger auf den Registrierungspuffer zurück, den der Aufrufer angefordert hat, oder NULL-, wenn ein Fehler verhindert, dass der Speicher zugewiesen wird.
Bemerkungen
Jede Instanziierung eines Miniporttreibers kann jeweils nur einen Registrierungspuffer zugeordnet haben. Wenn ein Miniporttreiber versucht, mehrere Registrierungspuffer zuzuweisen, schlägt die Zuordnung fehl, und StorPortAllocateRegistryBuffer gibt NULL-zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | storport.h (include Storport.h) |
| Library | Storport.lib |