Funzione GetTapeParameters (winbase.h)
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 |
---|---|
|
Recupera informazioni sul dispositivo nastro. |
|
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 |
---|---|
|
Tentativo di accesso ai dati prima dell'inizio del marcatore medio non riuscito. |
|
È stata rilevata una condizione di reimpostazione sul bus. |
|
Impossibile trovare le informazioni sulla partizione durante il caricamento di un nastro. |
|
L'indicatore di fine nastro è stato raggiunto durante un'operazione. |
|
È stato raggiunto un segno di file durante un'operazione. |
|
La dimensione del blocco non è corretta in un nuovo nastro in una partizione multivolume. |
|
Il nastro presente nell'unità è stato sostituito o rimosso. |
|
Il marcatore di fine dati è stato raggiunto durante un'operazione. |
|
Non è presente alcun supporto nell'unità. |
|
Il driver di nastro non supporta una funzione richiesta. |
|
Impossibile partizionare il nastro. |
|
È stato raggiunto un segno di impostazione durante un'operazione. |
|
Tentativo di blocco del meccanismo di espulsione non riuscito. |
|
Tentativo di scaricamento del nastro non riuscito. |
|
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 |