共用方式為

KsAddObjectCreateItemToDeviceHeader 函式 (ks.h)

  • 發行項

KsAddObjectCreateItemToDeviceHeader 函式會將指定的 create-item 新增至先前為這個裝置標頭配置的建立專案清單中的空白專案。 空的專案是由專案中的 NULL 建立分派函式所表示。 此函式假設呼叫端正在串行化建立專案清單的多個變更。

語法

KSDDKAPI NTSTATUS KsAddObjectCreateItemToDeviceHeader(
  [in]           KSDEVICE_HEADER      Header,
  [in]           PDRIVER_DISPATCH     Create,
  [in]           PVOID                Context,
  [in]           PWSTR                ObjectClass,
  [in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor
);

參數

[in] Header

指向包含先前配置的子建立數據表的裝置標頭。

[in] Create

指定建立分派函式。

[in] Context

指定內容參數。

[in] ObjectClass

指定 NULL 終止字元字串的指標，用於比較建立要求。 當裝置對象處於作用中狀態時，此指標必須保持有效。

[in, optional] SecurityDescriptor

指定安全性描述項。 當裝置對象處於作用中狀態時，這必須保持有效。 這是選擇性參數。

傳回值

如果找到空的建立專案位置並新增專案， KsAddObjectCreateItemToDeviceHeader 函式會傳回STATUS_SUCCESS。如果失敗，它會傳回STATUS_ALLOTTED_SPACE_EXCEEDED。

規格需求

需求 值
目標平台 Universal
標頭 ks.h (包含 Ks.h)
程式庫 Ks.lib