Funzione StorPortValidateRange (storport.h)

Articolo
02/07/2025

La routine StorPortValidateRange determina se un intervallo specificato di indirizzi I/O è in uso da un'altra scheda. Questa routine è obsoleta nei sistemi operativi Windows NT 4.0 e versioni successive.

Sintassi

STORPORT_API BOOLEAN StorPortValidateRange(
  [in] PVOID                 HwDeviceExtension,
  [in] INTERFACE_TYPE        BusType,
       ULONG                 SystemIoBusNumber,
  [in] STOR_PHYSICAL_ADDRESS IoAddress,
  [in] ULONG                 NumberOfBytes,
  [in] BOOLEAN               InIoSpace
);

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.

[in] BusType

Contiene un valore di tipo STORAGE_BUS_TYPE che indica il tipo di bus.

SystemIoBusNumber

Contiene un numero intero che identifica un bus di sistema.

[in] IoAddress

Contiene l'indirizzo iniziale dell'intervallo di indirizzi da convalidare.

[in] NumberOfBytes

Contiene la lunghezza in byte dell'intervallo di indirizzi da convalidare.

[in] InIoSpace

Indica, quando TRUE, che l'intervallo di indirizzi si trova nello spazio di I/O. Se FALSE, l'indirizzo si trova nello spazio di memoria.

Valore restituito

StorPortValidateRange restituisce TRUE se un intervallo di indirizzi specificato non è richiesto da un altro driver. Questa routine restituisce false se un altro driver ha richiesto l'intervallo di indirizzi.

Osservazioni

Per la compatibilità con le versioni precedenti di Windows, questa routine restituisce sempre TRUE.

Ai driver Miniport vengono assegnati intervalli di I/O validi nel AccessRanges membro della struttura di PORT_CONFIGURATION_INFORMATION quando il driver Storport chiama la routine di callback HwStorFindAdapter del miniport.

StorPortValidateRange usa STOR_PHYSICAL_ADDRESS per rappresentare gli indirizzi relativi al bus.

typedef PHYSICAL_ADDRESS STOR_PHYSICAL_ADDRESS, *PSTOR_PHYSICAL_ADDRESS;

Il tipo STOR_PHYSICAL_ADDRESS è un tipo di dati indipendente dal sistema operativo usato dai driver miniport Storport per rappresentare indirizzi fisici o un indirizzo relativo al bus.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
intestazione	storport.h (include Storport.h)
libreria	Storport.lib
regole di conformità DDI	StorPortDeprecated(storport)

Vedere anche

ScsiPortValidateRange

Condividi tramite