KsInitializeDriver 関数 (ks.h)
KsInitializeDriver 関数は、AVStream ミニドライバーのドライバー オブジェクトを初期化します。
構文
KSDDKAPI NTSTATUS KsInitializeDriver(
[in] PDRIVER_OBJECT DriverObject,
[in] PUNICODE_STRING RegistryPathName,
[in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);
パラメーター
[in] DriverObject
初期化される AVStream ドライバーの DRIVER_OBJECT 構造体へのポインター。 KsInitializeDriver を呼び出すミニドライバーは、オペレーティング システムによって DriverEntry に渡されるドライバー オブジェクトを使用する必要があります。
[in] RegistryPathName
オペレーティング システムによってミニドライバーの DriverEntry 関数に渡されるレジストリ パス文字列を含む Unicode 文字列へのポインター。
[in, optional] Descriptor
初期化されるデバイスの特性を指定する KSDEVICE_DESCRIPTOR 構造体へのポインター。 このポインターが NULL の場合、既定の特性を持ち、関連付けられたフィルター ファクトリを持たないデバイスが作成されます。
戻り値
KsInitializeDriver は、 IoCreateDevice または内部 AVStream デバイス初期化ルーチンによって返されるSTATUS_SUCCESSまたは適切なエラー コードを返します。
注釈
この関数は通常、 DriverEntry から呼び出されます。 ミニドライバーがデバイス記述子を渡す場合、AVStream は AddDevice 時に指定された特性を持つデバイスを作成します。 デバイスの初期化自体を実行するミニドライバーは、必ずしも KsInitializeDriver を呼び出す必要はありません。 詳細については、「 AVStream ミニドライバーの初期化」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | ks.h (Ks.h を含む) |
| Library | Ks.lib |
| IRQL | PASSIVE_LEVEL |