次の方法で共有

KsAddObjectCreateItemToDeviceHeader 関数 (ks.h)

  • [アーティクル]

KsAddObjectCreateItemToDeviceHeader 関数は、指定した作成項目を、このデバイス ヘッダー用に以前に割り当てられた作成項目リストの空の項目に追加します。 空の項目は、エントリにディスパッチ関数を作成 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-terminated 文字列へのポインターを指定します。 デバイス オブジェクトがアクティブな間、このポインターは有効なままである必要があります。

[in, optional] SecurityDescriptor

セキュリティ記述子を指定します。 これは、デバイス オブジェクトがアクティブな間も有効なままである必要があります。 このパラメーターは省略可能です。

戻り値

KsAddObjectCreateItemToDeviceHeader 関数は、空のアイテム作成スロットが見つかり、項目が追加された場合にSTATUS_SUCCESSを返します。失敗した場合は、STATUS_ALLOTTED_SPACE_EXCEEDEDを返します。

必要条件

要件 価値
ターゲット プラットフォーム の 万国
ヘッダー ks.h (Ks.h を含む)
ライブラリ Ks.lib