GetTapeParameters

テープまたはテープドライブを記述する情報を取得する。

GetTapeParameters hDevice, dwOperation, lpdwSize, lpTapeInformation

hDevice : [intptr] 情報を取得するデバイスのハンドル。このハンドルは CreateFile 関数を使用して作成される。
dwOperation : [int] 
lpdwSize : [var] lpTapeInformation パラメータで指定されたバッファのサイズ（バイト単位）を受け取る変数へのポインタ。バッファが小さすぎる場合、このパラメータは必要なサイズを受け取る。
lpTapeInformation : [intptr] 要求された情報を含む構造体へのポインタ。dwOperation パラメータが GET_TAPE_MEDIA_INFORMATION の場合、lpTapeInformation は TAPE_GET_MEDIA_PARAMETERS 構造体を指す。dwOperation が GET_TAPE_DRIVE_INFORMATION の場合、lpTapeInformation は TAPE_GET_DRIVE_PARAMETERS 構造体を指す。

(プラグイン / モジュール : kernel32.dll)

解説

テープまたはテープドライブを記述する情報を取得する。

[戻り値]
関数が成功した場合、戻り値は NO_ERROR。関数が失敗した場合、以下のいずれかのエラーコードを返す。
（以下省略）

[備考]
dwOperation パラメータを GET_TAPE_DRIVE_INFORMATION 値に設定して呼び出した
GetTapeParameters
関数が返すブロックサイズ範囲値（最大と最小）は、ドライブの制限ではなくシステム制限を示す。ただし、真のブロックサイズ制限を決定するのはテープドライブデバイスとドライブ内のメディアである。したがって、アプリケーションは
dwOperation に GET_TAPE_DRIVE_INFORMATION
を指定して取得した範囲内のすべてのブロックサイズを設定できるとは限らない。

情報