KsCreateDevice 函式 (ks.h)

發行項
02/29/2024

KsCreateDevice 函式會建立AVStream裝置。

語法

KSDDKAPI NTSTATUS KsCreateDevice(
  [in]            PDRIVER_OBJECT            DriverObject,
  [in]            PDEVICE_OBJECT            PhysicalDeviceObject,
  [in, optional]  const KSDEVICE_DESCRIPTOR *Descriptor,
  [in]            ULONG                     ExtensionSize,
  [out, optional] PKSDEVICE                 *Device
);

參數

[in] DriverObject

minidriver 之 WDM 驅動程式物件的指標。

[in] PhysicalDeviceObject

您想要在 AVStream 下建立之裝置的 WDM 實體裝置物件的指標。

[in, optional] Descriptor

描述所建立裝置特性之裝置描述項的指標。如果呼叫端未指定這個選擇性參數，AVStream 會建立具有預設特性且沒有相關聯的篩選處理站的裝置。

[in] ExtensionSize

此參數包含裝置擴充功能的大小。如果這是零，則會使用預設延伸模組大小。如果沒有，它至少必須是大小 (KSDEVICE_HEADER) 。

[out, optional] Device

記憶體位置的指標，其中包含所建立 KSDEVICE 結構的位址。選擇性。

傳回值

如果已成功建立裝置，則傳回STATUS_SUCCESS。否則，它會傳回適當的錯誤碼。

備註

一般而言，minidriver 不會直接呼叫此函式。相反地， KsCreateDevice 是由預設 AddDevice 處理程式 KsAddDevice 呼叫。由於 KsAddDevice 對 KsCreateDevice 進行內部呼叫，因此呼叫 KsCreateDevice 的驅動程式不應該個別呼叫 KsAddDevice 。

直接呼叫 KsCreateDevice 的 minidriver 不應使用 KsInitializeDriver。如果 minidriver 未呼叫 KsInitializeDriver，它應該改為提供自己的 AddDevice 回呼。 minidriver 接著可以從該 AddDevice 回呼呼叫 KsCreateDevice。

如果未提供任何KSDEVICE_DESCRIPTOR，AVStream 會建立具有預設特性且沒有相關聯的篩選處理站的裝置。如果提供KSDEVICE_DESCRIPTOR，且包含具有建立分派的KSDEVICE_DISPATCH 數據表，則會呼叫建立分派。

規格需求

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