KsInitializeDevice 函式 (ks.h)

發行項
03/01/2024

KsInitializeDevice 函式是由AVStream呼叫，以從 KsCreateDevice 內初始化 AVStream 裝置類別。

語法

KSDDKAPI NTSTATUS KsInitializeDevice(
  [in]           PDEVICE_OBJECT            FunctionalDeviceObject,
  [in]           PDEVICE_OBJECT            PhysicalDeviceObject,
  [in]           PDEVICE_OBJECT            NextDeviceObject,
  [in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);

參數

[in] FunctionalDeviceObject

DEVICE_OBJECT 結構的指標，代表要初始化之裝置的 WDM 功能裝置物件。

一般而言，這會從 IoCreateDevice 呼叫傳回。直接呼叫此函式的 Minidrivers 負責呼叫 IoCreateDevice ，並將自己附加至裝置堆棧。

[in] PhysicalDeviceObject

DEVICE_OBJECT 結構的指標，代表要初始化之裝置的 WDM 實體裝置物件。

[in] NextDeviceObject

裝置堆疊中下一個 DEVICE_OBJECT 結構的指標，由呼叫 IoAttachDeviceToDeviceStack 所決定。

[in, optional] Descriptor

描述所初始化裝置特性之KSDEVICE_DESCRIPTOR 結構的指標。如果此參數為 NULL，則會使用預設特性初始化裝置，而且沒有相關聯的篩選處理站。

傳回值

KsInitializeDevice 如果裝置已成功初始化，則會傳回STATUS_SUCCESS。否則，它會傳回適當的錯誤碼。

備註

大部分的迷你驅動程式不會直接呼叫此函式。只有在 minidriver 不使用 KsInitializeDriver 進行初始化時，才呼叫 KsInitializeDevice、獨立處理 AddDevice，而且不會在其 AddDevice 處理程式中使用 KsAddDevice 或 KsCreateDevice。

規格需求

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