KsInitializeDriver 函式 (ks.h)

發行項
02/26/2024

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

語法

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

參數

[in] DriverObject

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

[in] RegistryPathName

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

[in, optional] Descriptor

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

傳回值

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

備註

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

規格需求

需求	值
最低支援的用戶端	適用於 Microsoft Windows XP 和更新版本的作業系統和 DirectX 8.0 和更新版本的 DirectX。
目標平台	Universal
標頭	ks.h (包含 Ks.h)
程式庫	Ks.lib
IRQL	PASSIVE_LEVEL