Funzione SCSIPortGetLogicalUnit (srb.h)
La routine SCSIPortGetLogicUnit restituisce un puntatore all'area di archiviazione per ogni unità del driver miniport per una determinata periferica.
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.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Desktop |
Intestazione | srb.h (include Miniport.h, SCSI.h) |
Libreria | Scsiport.lib |