KsInitializeDevice 関数 (ks.h)
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 |