Funzione StorPortAllocateHostMemoryBuffer (storport.h)

StorPortAllocateHostMemoryBuffer alloca uno o più intervalli di memoria fisicamente contigua da usare come buffer di memoria host (HMB).

Sintassi

ULONG StorPortAllocateHostMemoryBuffer(
  [in]           PVOID            HwDeviceExtension,
  [in]           SIZE_T           MinimumBytes,
  [in]           SIZE_T           PreferredBytes,
  [in]           ULONGLONG        UtilizationBytes,
  [in]           ULONG            AlignmentBytes,
  [in]           PHYSICAL_ADDRESS LowestAcceptableAddress,
  [in]           PHYSICAL_ADDRESS HighestAcceptableAddress,
  [in, optional] PHYSICAL_ADDRESS BoundaryAddressMultiple,
  [in, out]      PACCESS_RANGE    PhysicalAddressRanges,
  [in, out]      PULONG           PhysicalAddressRangeCount
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware per l'adattatore del bus host (HBA).

[in] MinimumBytes

Quantità minima di memoria che sarà utile per il dispositivo, in byte. Un valore pari a 0 indica che qualsiasi dimensione della memoria fino alla dimensione preferita è accettabile.

[in] PreferredBytes

Quantità di memoria preferita dal dispositivo, in byte. Questo deve essere un multiplo delle dimensioni della pagina.

[in] UtilizationBytes

Numero totale di blocchi allocati nel dispositivo, in byte.

[in] AlignmentBytes

Requisito di allineamento del buffer di memoria host dal dispositivo.

[in] LowestAcceptableAddress

Indirizzo fisico più basso valido per l'allocazione. Ad esempio, se il dispositivo può fare riferimento solo alla memoria fisica nell'intervallo da 8 MB a 16 MB, questo valore verrà impostato su 0x800000 (8 MB).

[in] HighestAcceptableAddress

Indirizzo fisico più alto valido per l'allocazione. Ad esempio, se il dispositivo può fare riferimento solo alla memoria fisica inferiore a 16 MB, questo valore verrà impostato su 0xFFFFFF (16 MB - 1).

[in, optional] BoundaryAddressMultiple

Indirizzo fisico multiplo che questa allocazione non deve attraversare. Questo parametro attualmente non viene usato e deve essere impostato su 0.

[in, out] PhysicalAddressRanges

Matrice di intervalli di indirizzi fisici che costituiscono il buffer di memoria host. Il chiamante deve fornire una matrice pre-allocata. StorPortAllocateHostMemoryBuffer riempirà la matrice con uno o più intervalli di indirizzi fisici.

[in, out] PhysicalAddressRangeCount

Numero di voci in PhysicalAddressRanges. Questa funzione aggiornerà questo parametro per indicare il numero di intervalli di indirizzi fisici compilati.

Valore restituito

StorPortAllocateHostMemoryBuffer restituisce uno dei codici di stato seguenti:

Commenti

HMB è memoria che il dispositivo può usare direttamente ed esclusivamente. Il dispositivo può usare questa memoria, ma deve assicurarsi che non vi sia perdita di dati o danneggiamento dei dati in caso di rimozione di sorprese o perdita di energia imprevista.

A seconda dei criteri di allocazione, questa funzione può allocare quanto le dimensioni preferite del dispositivo, quanto le dimensioni minime del dispositivo o nessuna memoria.

Questa funzione tenterà di allocare quanto più intervalli di indirizzi contigui fisicamente possibili, ma potrebbe dover usare più intervalli di indirizzi fisici per soddisfare le dimensioni HMB desiderate.

Il chiamante deve successivamente chiamare StorPortFreeHostMemoryBuffer quando viene eseguito con il buffer di memoria host.

Requisiti

Vedi anche

StorPortFreeHostMemoryBuffer