KsInitializeDriver 関数 (ks.h)

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

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