StreamClassRegisterAdapter 函式 (strmini.h)
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
指向 HW_INITIALIZATION_DATA 結構,提供類別驅動程式開始初始化 minidriver 所需的資訊。
傳回值
傳回成功時STATUS_SUCCESS,或失敗時的適當錯誤碼。
言論
stream minidriver 必須在 DriverEntry 例程內呼叫 StreamClassRegisterMinidriver。
stream 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 結構中傳遞的大部分資訊都會通知類別驅動程式迷你驅動程式全小型驅動程式回呼,以及要配置給minidriver資料結構的大小緩衝區。 類別驅動程式會透過 SRB_INITIALIZE_DEVICE 和 SRB_GET_STREAM_INFO 要求,查詢minidriver StrMiniReceiveDevicePacket 例程的其他啟動資訊(傳遞為 HW_INITIALIZATION_DATA HwReceivePacket 成員)。
註冊之後,minidriver 可以驅動系統中任意數目的配接器實例。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | strmini.h (包括 Strmini.h) |