STORAGE_ADAPTER_DESCRIPTOR struttura (winioctl.h)

Articolo
03/13/2024

Usato con il codice di controllo IOCTL_STORAGE_QUERY_PROPERTY per recuperare i dati dell'adattatore di archiviazione per un dispositivo.

Sintassi

typedef struct _STORAGE_ADAPTER_DESCRIPTOR {
  DWORD   Version;
  DWORD   Size;
  DWORD   MaximumTransferLength;
  DWORD   MaximumPhysicalPages;
  DWORD   AlignmentMask;
  BOOLEAN AdapterUsesPio;
  BOOLEAN AdapterScansDown;
  BOOLEAN CommandQueueing;
  BOOLEAN AcceleratedTransfer;
#if ...
  BOOLEAN BusType;
#else
  BYTE    BusType;
#endif
  WORD    BusMajorVersion;
  WORD    BusMinorVersion;
  BYTE    SrbType;
  BYTE    AddressType;
} STORAGE_ADAPTER_DESCRIPTOR, *PSTORAGE_ADAPTER_DESCRIPTOR;

Members

Version

Contiene le dimensioni di questa struttura, in byte. Il valore di questo membro verrà modificato quando i membri vengono aggiunti alla struttura.

Size

Specifica la dimensione totale dei dati restituiti, in byte. Questo può includere dati che seguono questa struttura.

MaximumTransferLength

Specifica il numero massimo di byte che l'adattatore di archiviazione può trasferire in una singola operazione.

MaximumPhysicalPages

Specifica il numero massimo di pagine fisiche discontinue che l'adattatore di archiviazione può gestire in un singolo trasferimento (in altre parole, l'estensione del supporto di dispersione/raccolta).

AlignmentMask

Specifica i requisiti di allineamento dell'adattatore di archiviazione per i trasferimenti. La maschera di allineamento indica restrizioni di allineamento per i buffer richiesti dall'adattatore di archiviazione per le operazioni di trasferimento. I valori della maschera validi sono limitati anche dalle caratteristiche dei gestori di memoria in versioni diverse di Windows.

Valore	Significato
0	I buffer devono essere allineati ai limiti BYTE .
1	I buffer devono essere allineati ai limiti di WORD .
3	I buffer devono essere allineati ai limiti DWORD32 .
7	I buffer devono essere allineati ai limiti DWORD64 .

AdapterUsesPio

Se questo membro è TRUE, l'adattatore di archiviazione usa l'I/O programmato (PIO) e richiede l'uso di indirizzi virtuali nello spazio di sistema mappati alla memoria fisica per i buffer di dati. Quando questo membro è FALSE, l'adattatore di archiviazione non usa PIO.

AdapterScansDown

Se questo membro è TRUE, l'adattatore di archiviazione esegue l'analisi per i dispositivi BIOS, ovvero, l'adattatore di archiviazione inizia l'analisi con il numero di dispositivo più alto anziché quello più basso. Quando questo membro è FALSE, l'adattatore di archiviazione inizia l'analisi con il numero di dispositivo più basso. Questo membro è riservato ai driver miniport legacy.

CommandQueueing

Se questo membro è TRUE, l'adattatore di archiviazione supporta accodamento con tag SCSI e/o code interne per unità logiche o equivalente non SCSI. Quando questo membro è FALSE, l'adapter di archiviazione non supporta l'accodamento con tag SCSI né le code interne per unità logiche.

AcceleratedTransfer

Se questo membro è TRUE, l'adattatore di archiviazione supporta i trasferimenti sincroni come modo per velocizzare l'I/O. Quando questo membro è FALSE, l'adattatore di archiviazione non supporta i trasferimenti sincroni come modo per velocizzare l'I/O.

BusType

Specifica un valore di tipo STORAGE_BUS_TYPE che indica il tipo del bus a cui è connesso il dispositivo.

BusMajorVersion

Specifica il numero di versione principale, se presente, dell'adattatore di archiviazione.

BusMinorVersion

Specifica il numero di versione secondaria, se presente, dell'adattatore di archiviazione.

SrbType

Specifica il tipo di blocco di richieste SCSI (SRB) usato dall'HBA.

Valore	Significato
SRB_TYPE_SCSI_REQUEST_BLOCK	L'HBA usa blocchi di richiesta SCSI.
SRB_TYPE_STORAGE_REQUEST_BLOCK	L'HBA usa blocchi di richiesta SCSI estesi.

Questo membro è valido a partire da Windows 8.

AddressType

Specifica il tipo di indirizzo dell'HBA.

Valore	Significato
STORAGE_ADDRESS_TYPE_BTL8	L'HBA usa un bus a 8 bit, la destinazione e l'indirizzamento LUN.

Questo membro è valido a partire da Windows 8.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	winioctl.h (include Windows.h)

Vedi anche

Strutture di gestione dei dischi

IOCTL_STORAGE_QUERY_PROPERTY

STORAGE_ADAPTER_DESCRIPTOR

STORAGE_DESCRIPTOR_HEADER

STORAGE_DEVICE_ID_DESCRIPTOR

Condividi tramite