Funzione SCSIPortGetLogicalUnit (srb.h)

Articolo
02/29/2024

La routine SCSIPortGetLogicUnit restituisce un puntatore all'area di archiviazione per ogni unità del driver miniport per una determinata periferica.

Nota I modelli di driver di porta SCSI e miniport SCSI possono essere modificati o non disponibili in futuro. È invece consigliabile usare i modelli di driver Storport e Miniport Storport.

Sintassi

SCSIPORT_API PVOID ScsiPortGetLogicalUnit(
  [in] PVOID HwDeviceExtension,
  [in] UCHAR PathId,
  [in] UCHAR TargetId,
  [in] UCHAR Lun
);

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 in genere archiviano informazioni specifiche di HBA in questa estensione, ad esempio lo stato dell'HBA e gli intervalli di accesso mappati di HBA. Questa area è disponibile per il driver miniport nel membro DeviceExtension-HwDeviceExtension> dell'oggetto dispositivo HBA immediatamente dopo che il driver miniport chiama SCSIPortInitialize. Il driver di porta libera questa memoria quando rimuove il dispositivo.

[in] PathId

Identifica il bus SCSI.

[in] TargetId

Identifica il controller di destinazione o il dispositivo nel bus.

[in] Lun

Identifica il numero di unità logica del dispositivo di destinazione.

Valore restituito

SCSIPortGetLogicalUnit restituisce un puntatore all'area di archiviazione del driver miniport per l'unità logica richiesta. Se il driver di porta specifico del sistema operativo considera l'unità logica non esistente, restituisce NULL.

Commenti

SCSIPortGetLogicalUnit è irrilevante se la routine DriverEntry del driver miniport è stata specificata zero per LuExtensionSize nella HW_INITIALIZATION_DATA quando ha chiamato SCSIPortInitialize. In caso contrario, il driver di porta specifico del sistema operativo alloca e inizializza con zero un set di estensioni LU delle dimensioni specificate per il driver miniport da usare.

L'archiviazione per lu può essere usata per archiviare i dati pertinenti a una determinata periferica, ad esempio i puntatori dati salvati. Per accedere a questa area, il driver miniport chiama SCSIPortGetLogicalUnit quando il driver mantiene informazioni sullo stato dell'operazione o corrente per qualsiasi periferica specifica.

Il driver di porta specifico del sistema operativo può considerare un'unità logica non esistente se non esiste alcuna richiesta attiva per tale unità logica e il dispositivo non è mai stato selezionato correttamente.