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 per hba che il driver di porta alloca e inizializza per conto del driver miniport. I driver Miniport archivia in genere 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 subito dopo che il driver miniport chiama StorPortInitialize. Il driver della 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 long che indica, all'input, la lunghezza in byte del buffer del Registro di sistema richiesto dal chiamante. Nell'output, lunghezza viene aggiornata in modo da riflettere le dimensioni effettive in byte del buffer allocato.
Valore restituito
StorPortAllocateRegistryBuffer restituisce un puntatore al buffer del Registro di sistema richiesto dal chiamante oppure NULL se un errore impedisce l'allocazione della memoria.
Osservazioni
Ogni creazione di istanze di un driver miniport può avere un solo 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | storport.h (include Storport.h) |
| libreria | Storport.lib |