struktur TAPE_INIT_DATA_EX (minitape.h)

Artikel
08/07/2023

TAPE_INIT_DATA_EX mendefinisikan nilai dan rutinitas yang khusus untuk driver miniclass pita Windows 2000. Rutinitas DriverEntry miniclass pita meneruskan informasi ini ke driver kelas kaset untuk menyelesaikan inisialisasi driver miniclass.

Sintaks

typedef struct _TAPE_INIT_DATA_EX {
  ULONG                        InitDataSize;
  TAPE_VERIFY_INQUIRY_ROUTINE  VerifyInquiry;
  BOOLEAN                      QueryModeCapabilitiesPage;
  ULONG                        MinitapeExtensionSize;
  TAPE_EXTENSION_INIT_ROUTINE  ExtensionInit;
  ULONG                        DefaultTimeOutValue;
  TAPE_ERROR_ROUTINE           TapeError;
  ULONG                        CommandExtensionSize;
  TAPE_PROCESS_COMMAND_ROUTINE CreatePartition;
  TAPE_PROCESS_COMMAND_ROUTINE Erase;
  TAPE_PROCESS_COMMAND_ROUTINE GetDriveParameters;
  TAPE_PROCESS_COMMAND_ROUTINE GetMediaParameters;
  TAPE_PROCESS_COMMAND_ROUTINE GetPosition;
  TAPE_PROCESS_COMMAND_ROUTINE GetStatus;
  TAPE_PROCESS_COMMAND_ROUTINE Prepare;
  TAPE_PROCESS_COMMAND_ROUTINE SetDriveParameters;
  TAPE_PROCESS_COMMAND_ROUTINE SetMediaParameters;
  TAPE_PROCESS_COMMAND_ROUTINE SetPosition;
  TAPE_PROCESS_COMMAND_ROUTINE WriteMarks;
  TAPE_PROCESS_COMMAND_ROUTINE PreProcessReadWrite;
  TAPE_PROCESS_COMMAND_ROUTINE TapeGetMediaTypes;
  ULONG                        MediaTypesSupported;
  TAPE_PROCESS_COMMAND_ROUTINE TapeWMIOperations;
  ULONG                        Reserved[2];
} TAPE_INIT_DATA_EX, *PTAPE_INIT_DATA_EX;

Anggota

InitDataSize

Ukuran struktur ini, dalam byte.

VerifyInquiry

Menentukan titik masuk rutin tape miniclass driver TapeMiniVerifyInquiry , yang menentukan apakah driver mendukung perangkat tertentu. Rutinitas ini diperlukan.

QueryModeCapabilitiesPage

Mengarahkan driver kelas kaset ketika TRUE untuk melewati halaman kemampuan mode ke tape miniclass driver TapeMiniVerifyInquiry dan Rutinitas TapeMiniExtensionInit .

MinitapeExtensionSize

Menentukan ukuran, dalam byte, dari area konteks khusus driver. Jika anggota ini bukan nol, ExtensionInit tidak boleh NULL. Nilai ini bersifat opsional dan harus diatur ke nol jika tidak digunakan.

ExtensionInit

Arahkan ke rutinitas tape miniclass driver TapeMiniExtensionInit , yang menginisialisasi ekstensi minitape opsional, jika ada. Jika MiniTapeExtensionSize adalah nol, ExtensionInit harus NULL.

DefaultTimeOutValue

Menentukan jumlah detik driver kelas pita menunggu permintaan SRB sebelum membatalkannya. Jika nilai ini nol, driver kelas pita menetapkan nilai default yang sesuai. Driver kelas pita selalu menggunakan nilai batas waktu default untuk permintaan baca dan tulis. Rutinitas yang terkandung dalam struktur TAPE_INIT_DATA_EX dapat menggantikan nilai batas waktu default untuk permintaan kontrol perangkat dengan mengatur TimeOutValue dalam SRB.

TapeError

Arahkan kursor ke rutinitas TapeMiniTapeError driver miniclass, yang menambah aktivitas penanganan kesalahan driver kelas tape. Rutinitas ini bersifat opsional. Jika tidak digunakan, TapeError harus diatur ke NULL.

CommandExtensionSize

Menentukan ukuran, dalam byte, dari ekstensi perintah yang akan dialokasikan sebelum awal setiap perintah pita. Driver miniclass pita menggunakan ekstensi perintah untuk menyimpan konteks selama pemrosesan perintah pita. Ukuran dan struktur internalnya ditentukan oleh driver miniclass pita. Ekstensi perintah bersifat opsional. Jika tidak digunakan, CommandExtensionSize harus diatur ke nol.

CreatePartition

Arahkan ke rutinitas TapeMiniCreatePartition driver miniclass pita, yang membuat partisi pada pita. Rutinitas ini diperlukan.

Erase

Arahkan kursor ke rutinitas TapeMiniErase driver miniclass, yang menghapus kaset. Rutinitas ini diperlukan.

GetDriveParameters

Arahkan ke rutinitas TapeMiniGetDriveParameters driver miniclass pita, yang menangani permintaan untuk mendapatkan parameter drive. Rutinitas ini diperlukan.

GetMediaParameters

Arahkan ke rutinitas TapeMiniGetMediaParameters driver miniclass pita, yang menangani permintaan untuk mendapatkan parameter media. Rutinitas ini diperlukan.

GetPosition

Arahkan ke rutinitas TapeMiniGetPosition driver miniclass pita, yang menangani permintaan untuk mendapatkan posisi pita. Rutinitas ini diperlukan.

GetStatus

Arahkan ke rutinitas TapeMiniGetStatus driver miniclass pita, yang menangani permintaan status. Rutinitas ini diperlukan.

Prepare

Arahkan ke rutinitas TapeMiniPrepare driver miniclass pita, yang menyiapkan perangkat pita. Rutinitas ini diperlukan.

SetDriveParameters

Arahkan ke rutinitas TapeMiniSetDriveParameters driver miniclass pita, yang mengatur parameter drive. Rutinitas ini diperlukan.

SetMediaParameters

Arahkan ke rutinitas TapeMiniSetMediaParameters driver miniclass pita, yang mengatur parameter media. Rutinitas ini diperlukan.

SetPosition

Arahkan ke rutinitas TapeMiniSetPosition driver miniclass pita, yang memposisikan pita. Rutinitas ini diperlukan.

WriteMarks

Arahkan ke rutinitas TapeMiniWriteMarks driver miniclass pita, yang menulis tanda ke pita. Rutinitas ini diperlukan.

PreProcessReadWrite

Arahkan ke rutinitas tape miniclass driver TapeMiniPreProcessReadWrite , yang menjalankan operasi khusus perangkat sebelum semua baca dan tulis. Rutinitas ini bersifat opsional dan tidak diperlukan oleh sebagian besar driver. Jika tidak digunakan, PreProcessReadWrite harus NULL.

TapeGetMediaTypes

Arahkan ke rutinitas TapeMiniGetMediaTypes driver miniclass, yang mendapatkan deskripsi setiap jenis media yang didukung oleh perangkat pita. Rutinitas ini diperlukan.

MediaTypesSupported

Menunjukkan jumlah jenis media yang didukung oleh perangkat.

TapeWMIOperations

Arahkan ke rutinitas TapeMiniWMIControl .

Reserved[2]

Dicadangkan.

Keterangan

DriverEntry driver miniclass tape rutin memanggil TapeClassZeroMemory untuk menghapus TAPE_INIT_DATA_EX, mengisi anggota yang diperlukan dan anggota opsional yang sesuai, dan TapeClassInitialize dengan pointer ke struktur ini.

Nama-nama rutinitas driver miniclass pita yang ditunjukkan dalam deskripsi anggota struktur ini hanyalah nama tempat penampung. Prototipe untuk rutinitas ini dinyatakan dalam newtape.h sebagai TAPE_PROCESS_COMMAND_ROUTINE.

Arti dari parameter prototipe ini berbeda untuk setiap rutinitas driver miniclass. Untuk informasi terperinci tentang bagaimana parameter ini digunakan, lihat deskripsi untuk setiap rutinitas driver miniclass individu.