KsInitializeDevice 関数 (ks.h)
KsInitializeDevice 関数は、AVStream によって呼び出され、KsCreateDevice内から 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 バージョンで使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | ks.h (Ks.h を含む) |
| ライブラリ | Ks.lib |
| IRQL | PASSIVE_LEVEL |
関連項目
IoAttachDeviceToDeviceStack の
IoCreateDevice の
KSDEVICE の
KsAddDevice を する
KsInitializeDriver の