次の方法で共有


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 バージョンで使用できます。
ターゲット プラットフォーム 万国
ヘッダー ks.h (Ks.h を含む)
ライブラリ Ks.lib
IRQL PASSIVE_LEVEL

関連項目

DEVICE_OBJECT

DRIVER_OBJECT

AVStream DriverEntry

IoCreateDevice

KSDEVICE_DESCRIPTOR

KSDEVICE_DISPATCH

KSFILTER_DESCRIPTOR

KsInitializeDevice