TAPE_EXTENSION_INIT_ROUTINE minitape.h (回呼函式)

發行項
02/27/2024

ExtensionInit 會初始化選擇性的驅動程式特定內容區域。載入磁帶迷你類別驅動程式時， TapeClassInitialize 會呼叫此例程。此例程是選擇性的。

語法

TAPE_EXTENSION_INIT_ROUTINE TapeExtensionInitRoutine;

void TapeExtensionInitRoutine(
  [in] PVOID MinitapeExtension,
  [in] PINQUIRYDATA InquiryData,
  [in] PMODE_CAPABILITIES_PAGE ModeCapabilitiesPage
)
{...}

參數

[in] MinitapeExtension

初始化磁帶迷你類別驅動程式所要求大小的緩衝區指標。

[in] InquiryData

磁帶裝置的 SCSI 查詢數據指標。

[in] ModeCapabilitiesPage

緩衝區的指標，其中包含磁帶裝置的低階資訊。此頁面的格式是由 QIC 157 標準所定義，而且可能會變更。如果裝置不支援模式功能頁面，這會是 NULL 。

傳回值

無

備註

磁帶迷你類別驅動程序藉由在 TAPE_INIT_DATA_EX 結構中指定 MinitapeExtensionSize 的非零值，以要求 minitape 擴充功能，它會從其 DriverEntry 例程傳遞至 TapeClassInitialize。 miniclass 驅動程式會定義minitape延伸模組的結構和內容，而且通常會使用它來儲存其支援的裝置查詢數據。

磁帶類別驅動程式會配置 minitape 擴充功能，並在後續呼叫磁帶迷你類別驅動程式的例程中提供它，以處理裝置控制要求的裝置特定層面，以及迷你類別驅動程式的選擇性 TapeMiniTapeError 例程。

ExtensionInit 會初始化 minitape 擴充功能，而迷你類別驅動程式會使用此區域來維護其裝置的運行時間狀態。磁帶類別驅動程式會將 InquiryData 和 ModeCapabilitiesPage 傳遞給此例程，因為這些結構包含磁帶迷你類別驅動程式可能想要儲存在 minitape 擴充功能中的資訊。