KsInitializeDevice 函式 (ks.h)
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 |