KsInitializeDriver 函式（ks.h）

發行項
02/07/2025

KsInitializeDriver 函式會初始化 AVStream 迷你驅動程式的驅動程序物件。

語法

KSDDKAPI NTSTATUS KsInitializeDriver(
  [in]           PDRIVER_OBJECT            DriverObject,
  [in]           PUNICODE_STRING           RegistryPathName,
  [in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);

參數

[in] DriverObject

要初始化之 AVStream 驅動程式之 DRIVER_OBJECT 結構的指標。呼叫 KsInitializeDriver 的 Minidrivers 應該使用作系統傳遞給 DriverEntry 的驅動程序物件。

[in] RegistryPathName

Unicode 字串的指標，其中包含由作系統傳遞至minidriver DriverEntry 函式的登錄路徑字串。

[in, optional] Descriptor

KSDEVICE_DESCRIPTOR 結構的指標，指定要初始化之裝置的特性。如果此指標 NULL，則會建立具有預設特性且沒有相關聯的篩選處理站的裝置。

傳回值

KsInitializeDriver 會傳回STATUS_SUCCESS或適當的錯誤碼，如 ioCreateDevice 或內部 AVStream 裝置初始化例程所傳回。

言論

此函式通常會從 DriverEntry呼叫。如果 minidriver 傳入裝置描述元，AVStream 會在 AddDevice 時間建立具有指定特性的裝置。執行裝置初始化本身的迷你驅動程式不一定需要呼叫 KsInitializeDriver。如需詳細資訊，請參閱初始化 AVStream Minidriver。

要求

要求	價值
最低支援的用戶端	Microsoft Windows XP 和更新版本的作系統和 DirectX 8.0 和更新版本的 DirectX 版本中提供。
目標平臺	普遍
標頭	ks.h （包括 Ks.h）
連結庫	Ks.lib
IRQL	PASSIVE_LEVEL