Funzione StorPortAllocateRegistryBuffer (storport.h)
La routine StorPortAllocateRegistryBuffer viene chiamata dal driver miniport per allocare un buffer che può essere usato per leggere e scrivere dati del Registro di sistema.
Sintassi
STORPORT_API PUCHAR StorPortAllocateRegistryBuffer(
[in] PVOID HwDeviceExtension,
[in] PULONG Length
);
Parametri
[in] HwDeviceExtension
Puntatore all'estensione del dispositivo hardware. Si tratta di un'area di archiviazione hbA che il driver di porta alloca e inizializza per conto del driver miniport. I driver miniport in genere archiviano informazioni specifiche di HBA in questa estensione, ad esempio lo stato dell'HBA e gli intervalli di accesso mappati per l'HBA. Questa area è disponibile per il driver miniport immediatamente dopo che il driver miniport chiama StorPortInitialize. Il driver di porta libera questa memoria quando rimuove il dispositivo. Il driver miniport deve essere in esecuzione in IRQL PASSIVE_LEVEL quando chiama questa routine.
[in] Length
Puntatore a un valore lungo che indica, in input, la lunghezza in byte del buffer del Registro di sistema richiesta dal chiamante. In output, la lunghezza viene aggiornata per riflettere le dimensioni effettive in byte del buffer allocato.
Valore restituito
StorPortAllocateRegistryBuffer restituisce un puntatore al buffer del Registro di sistema richiesto dal chiamante o NULL se un errore impedisce l'allocazione della memoria.
Commenti
Ogni istanza di un driver miniport può avere solo un buffer del Registro di sistema allocato alla volta. Se un driver miniport tenta di allocare più buffer del Registro di sistema, l'allocazione avrà esito negativo e StorPortAllocateRegistryBuffer restituirà NULL.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | Storport.h (include Storport.h) |
| Libreria | Storport.lib |