KsInitializeDevice 関数 (ks.h)

[アーティクル]
08/07/2023

KsInitializeDevice 関数は、KsCreateDevice 内から AVStream デバイスクラスを初期化するために AVStream によって呼び出されます。

構文

KSDDKAPI NTSTATUS KsInitializeDevice(
  [in]           PDEVICE_OBJECT            FunctionalDeviceObject,
  [in]           PDEVICE_OBJECT            PhysicalDeviceObject,
  [in]           PDEVICE_OBJECT            NextDeviceObject,
  [in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);

パラメーター

[in] FunctionalDeviceObject

初期化されるデバイスの WDM 機能デバイスオブジェクトを表す DEVICE_OBJECT 構造体へのポインター。

通常、これは IoCreateDevice 呼び出しから返されます。この関数を直接呼び出すミニドライバーは、 IoCreateDevice を呼び出し、デバイススタックにアタッチする役割を担います。

[in] PhysicalDeviceObject

初期化されるデバイスの WDM 物理デバイスオブジェクトを表す DEVICE_OBJECT 構造体へのポインター。

[in] NextDeviceObject

IoAttachDeviceToDeviceStack の呼び出しによって決定される、デバイススタック内の次のDEVICE_OBJECT構造体へのポインター。

[in, optional] Descriptor

初期化されるデバイスの特性を記述する KSDEVICE_DESCRIPTOR 構造体へのポインター。このパラメーターが NULL の場合、デバイスは既定の特性で初期化され、関連付けられたフィルターファクトリはありません。

戻り値

KsInitializeDevice は、 デバイスが正常に初期化された場合にSTATUS_SUCCESSを返します。それ以外の場合は、適切なエラーコードを返します。

注釈

ほとんどのミニドライバーは、この関数を直接呼び出しません。ミニドライバーが初期化に KsInitializeDriver を使用せず、AddDevice を個別に処理し、その AddDeviceハンドラーでKsAddDevice または KsCreateDevice を使用しない場合にのみ、KsInitializeDevice を呼び出します。

要件

要件	値
サポートされている最小のクライアント	Microsoft Windows XP 以降のオペレーティングシステムと DirectX 8.0 以降の DirectX バージョンで使用できます。
対象プラットフォーム	ユニバーサル
Header	ks.h (Ks.h を含む)
Library	Ks.lib
IRQL	PASSIVE_LEVEL