KsAddDevice 関数 (ks.h)

KsAddDevice 関数は、KsInitializeDriver によってインストールされる既定 AddDevice ハンドラーです。

構文

KSDDKAPI NTSTATUS KsAddDevice(
  [in] PDRIVER_OBJECT DriverObject,
  [in] PDEVICE_OBJECT PhysicalDeviceObject
);

パラメーター

[in] DriverObject

ミニドライバーの WDM ドライバー オブジェクトへのポインター。

[in] PhysicalDeviceObject

WDM 物理デバイス オブジェクトへのポインター。

戻り値

デバイスが正常に作成されたことを示すSTATUS_SUCCESS、または IoCreateDevice または KsInitializeDevice エラー状態を返します。

備考

通常、AVStream ミニドライバーは、この関数を直接呼び出しません。

詳細については、「AVStream ミニドライバーの AddDevice ルーチン を参照してください。

KsAddDevice は、KsInitializeDriver への呼び出しから割り当てられたデバイス拡張機能 に格納されているデバイス記述子を抽出し、その呼び出しによって記述されたデバイスを作成します。 KsInitializeDriver を使用してドライバーを初期化しない場合、この関数は、既定の特性とフィルター ファクトリのないデバイスを作成します。 ミニドライバーには常に、KsCreateDevice を直接呼び出すオプションがあります。この場合、ドライバー拡張機能は AVStream で使用されません。 KsAddDevice KsCreateDevice 呼び出すので、KsAddDevice 呼び出すドライバーは、KsCreateDevice 個別に呼び出さないでください。

必要条件

要件 価値
サポートされる最小クライアント Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。
ターゲット プラットフォーム の 万国
ヘッダー ks.h (Ks.h を含む)
ライブラリ Ks.lib
IRQL PASSIVE_LEVEL

関連項目

DEVICE_OBJECT

DRIVER_OBJECT

KSDEVICE の

KsCreateDevice

KsDispatchIrp を する

KsInitializeDevice の

KsInitializeDriver の

  • Last updated on