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. 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] Length
Zeiger auf eine lange, die bei der Eingabe die Länge des Registrierungspuffers in Bytes angibt, die der Aufrufer benötigt. Bei der Ausgabe wird Die Länge aktualisiert, um die tatsächliche Größe des zugeordneten Puffers in Bytes widerzuspiegeln.
Rückgabewert
StorPortAllocateRegistryBuffer gibt einen Zeiger auf den vom Aufrufer angeforderten Registrierungspuffer zurück, oder NULL , wenn ein Fehler verhindert, dass der Arbeitsspeicher zugewiesen wird.
Hinweise
Für jede Instanziierung eines Miniporttreibers kann jeweils nur ein Registrierungspuffer zugewiesen werden. Wenn ein Miniporttreiber versucht, mehrere Registrierungspuffer zuzuweisen, schlägt die Zuordnung fehl, und StorPortAllocateRegistryBuffer gibt NULL zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | storport.h (einschließlich Storport.h) |
| Bibliothek | Storport.lib |