次の方法で共有


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を返します。

要件

要件
対象プラットフォーム ユニバーサル
Header ks.h (Ks.h を含む)
Library Ks.lib