Funzione StorPortValidateRange (storport.h)

  • Articolo

La routine StorPortValidateRange determina se un intervallo specificato di indirizzi di 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 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.

[in] BusType

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

SystemIoBusNumber

Contiene un 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, l'intervallo di indirizzi si trova nello spazio di I/O. Se FALSE, l'indirizzo è nello spazio di memoria.

Valore restituito

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

Commenti

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

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

StorPortValidateRange usa STOR_PHYSICAL_ADDRESS per rappresentare 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 che i driver miniport Storport usano per rappresentare indirizzi fisici o un indirizzo relativo al bus.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Intestazione Storport.h (include Storport.h)
Libreria Storport.lib
Regole di conformità DDI StorPortDeprecated(storport)

Vedi anche

SCSIPortValidateRange