Funzione GetTapeParameters (winbase.h)

Articolo
08/27/2023

La funzione GetTapeParameters recupera informazioni che descrivono il nastro o l'unità nastro.

Sintassi

DWORD GetTapeParameters(
  [in]  HANDLE  hDevice,
  [in]  DWORD   dwOperation,
  [out] LPDWORD lpdwSize,
  [out] LPVOID  lpTapeInformation
);

Parametri

[in] hDevice

Gestire il dispositivo su quali informazioni vengono cercate. Questo handle viene creato usando la funzione CreateFile .

[in] dwOperation

Tipo di informazioni richieste. Questo parametro deve essere uno dei valori seguenti.

Valore	Significato
GET_TAPE_DRIVE_INFORMATION 1	Recupera informazioni sul dispositivo nastro.
GET_TAPE_MEDIA_INFORMATION 0	Recupera informazioni sul nastro nel dispositivo nastro.

[out] lpdwSize

Puntatore a una variabile che riceve le dimensioni, in byte, del buffer specificato dal parametro lpTapeInformation . Se il buffer è troppo piccolo, questo parametro riceve le dimensioni necessarie.

[out] lpTapeInformation

Puntatore a una struttura contenente le informazioni richieste. Se il parametro dwOperation è GET_TAPE_MEDIA_INFORMATION, lpTapeInformation punta a una struttura TAPE_GET_MEDIA_PARAMETERS .

Se dwOperation è GET_TAPE_DRIVE_INFORMATION, lpTapeInformation punta a una struttura TAPE_GET_DRIVE_PARAMETERS .

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, può restituire uno dei codici di errore seguenti.

Codice di errore	Descrizione
ERROR_BEGINNING_OF_MEDIA 1102L	Tentativo di accesso ai dati prima dell'inizio del marcatore medio non riuscito.
ERROR_BUS_RESET 1111L	È stata rilevata una condizione di reimpostazione sul bus.
ERROR_DEVICE_NOT_PARTITIONED 1107L	Impossibile trovare le informazioni sulla partizione durante il caricamento di un nastro.
ERROR_END_OF_MEDIA 1100L	L'indicatore di fine nastro è stato raggiunto durante un'operazione.
ERROR_FILEMARK_DETECTED 1101L	È stato raggiunto un segno di file durante un'operazione.
ERROR_INVALID_BLOCK_LENGTH 1106L	La dimensione del blocco non è corretta in un nuovo nastro in una partizione multivolume.
ERROR_MEDIA_CHANGED 1110L	Il nastro presente nell'unità è stato sostituito o rimosso.
ERROR_NO_DATA_DETECTED 1104L	Il marcatore di fine dati è stato raggiunto durante un'operazione.
ERROR_NO_MEDIA_IN_DRIVE 1112L	Non è presente alcun supporto nell'unità.
ERROR_NOT_SUPPORTED 50L	Il driver di nastro non supporta una funzione richiesta.
ERROR_PARTITION_FAILURE 1105L	Impossibile partizionare il nastro.
ERROR_SETMARK_DETECTED 1103L	È stato raggiunto un segno di impostazione durante un'operazione.
ERROR_UNABLE_TO_LOCK_MEDIA 1108L	Tentativo di blocco del meccanismo di espulsione non riuscito.
ERROR_UNABLE_TO_UNLOAD_MEDIA 1109L	Tentativo di scaricamento del nastro non riuscito.
ERROR_WRITE_PROTECT 19L	Il supporto è protetto da scrittura.

Commenti

I valori dell'intervallo di dimensioni del blocco (massimo e minimo) restituiti dalla funzione GetTapeParameters chiamata con il parametro dwOperation impostato sul valore GET_TAPE_DRIVE_INFORMATION indicherà limiti di sistema, non limiti di unità. Tuttavia, si tratta del dispositivo unità nastro e dei supporti presenti nell'unità che determinano i limiti di dimensioni del blocco reali. Pertanto, un'applicazione potrebbe non essere in grado di impostare tutte le dimensioni del blocco menzionate nell'intervallo ottenuto specificando GET_TAPE_DRIVE_INFORMATION in dwOperation.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

CreateFile

SetTapeParameters

TAPE_GET_DRIVE_PARAMETERS

TAPE_GET_MEDIA_PARAMETERS

Condividi tramite