StreamClassRegisterAdapter 函式 (strmini.h)

發行項
03/01/2024

StreamClassRegisterAdapter 例程會註冊串流類別 minidriver。

只有回溯相容性才支援 StreamClassRegisterAdapter 名稱。

相反地，Microsoft 建議使用 StreamClassRegisterMinidriver，這是 StreamClassRegisterAdapter 的別名。 StreamClassRegisterMinidriver 的名稱更精確地指出例程會註冊串流類別 minidriver。註冊之後，minidriver 可以驅動系統中任意數目的適配卡實例。

StreamClassRegisterMinidriver 例程會向數據流類別驅動程式註冊串流迷你驅動程式。

語法

NTSTATUS STREAMAPI StreamClassRegisterAdapter(
  [in] PVOID                   Argument1,
  [in] PVOID                   Argument2,
  [in] PHW_INITIALIZATION_DATA HwInitializationData
);

參數

[in] Argument1

指向 minidriver 的 DriverEntry 例程的第一個自變數。

[in] Argument2

指向 minidriver 的 DriverEntry 例程的第二個自變數。

[in] HwInitializationData

指向提供類別驅動程式開始初始化 minidriver 所需的資訊 HW_INITIALIZATION_DATA 結構。

傳回值

傳回成功時STATUS_SUCCESS，或在失敗時傳回適當的錯誤碼。

備註

串流迷你驅動程序必須在 StreamClassRegisterMinidriver 的 DriverEntry 例程內呼叫 StreamClassRegisterMinidriver。

串流 minidriver 的 DriverEntry 會初始化數據流類別 minidriver。需要此例程。

Argument1 提供配接器 minidriver 應該呼叫 StreamClassRegisterMinidriver 的內容值。針對 Windows 2000 和更新版本，這會指向DRIVER_OBJECT。

Argument2 提供第二個內容值，配接器 minidriver 應該呼叫 StreamClassRegisterMinidriver。針對 Windows 2000 和更新版本，這會指向登錄路徑。

DriverEntry 會傳回其對 StreamClassRegisterMinidriver 的呼叫所傳回的值。

備註 DriverEntry 是串流類別 minidriver 的初始進入點。

由於 StreamClassRegisterMinidriver 會執行大部分必要的驅動程式初始化，因此串流類別 minidriver 的 DriverEntry 例程的主要工作是配置並填入具有驅動程式特定常數和進入點的HW_INITIALIZATION_DATA結構。 DriverEntry 應該接著呼叫 StreamClassRegisterMinidriver。

在 HW_INITIALIZATION_DATA 結構中傳遞的大部分資訊會通知類別驅動程式迷你驅動程式全驅動程式回呼，以及要配置給迷你驅動程式數據結構的大小緩衝區。類別驅動程式會透過 SRB_GET_STREAM_INFO SRB_INITIALIZE_DEVICE對minidriver的 StrMiniReceiveDevicePacket 例程 (傳遞為HW_INITIALIZATION_DATA) HwReceivePacket 成員的 hwReceivePacket 成員，查詢 minidriver 以取得其他啟動資訊。

註冊之後，minidriver 可以驅動系統中任意數目的適配卡實例。