KsCreateDevice 関数 (ks.h)
KsCreateDevice 関数は AVStream デバイスを作成します。
構文
KSDDKAPI NTSTATUS KsCreateDevice(
[in] PDRIVER_OBJECT DriverObject,
[in] PDEVICE_OBJECT PhysicalDeviceObject,
[in, optional] const KSDEVICE_DESCRIPTOR *Descriptor,
[in] ULONG ExtensionSize,
[out, optional] PKSDEVICE *Device
);
パラメーター
[in] DriverObject
ミニドライバーの WDM ドライバー オブジェクトへのポインター。
[in] PhysicalDeviceObject
AVStream で作成するデバイスの WDM 物理デバイス オブジェクトへのポインター。
[in, optional] Descriptor
作成されるデバイスの特性を記述するデバイス記述子へのポインター。 呼び出し元がこの省略可能なパラメーターを指定しない場合、AVStream は既定の特性を持ち、関連付けられたフィルター ファクトリを持たないデバイスを作成します。
[in] ExtensionSize
このパラメーターには、デバイス拡張機能のサイズが含まれています。 これが 0 の場合は、既定の拡張サイズが使用されます。 そうでない場合は、少なくとも sizeof (KSDEVICE_HEADER) である必要があります。
[out, optional] Device
作成された KSDEVICE 構造体のアドレスを含むメモリの場所へのポインター。 省略可能。
戻り値
デバイスが正常に作成された場合は、STATUS_SUCCESSを返します。 それ以外の場合は、適切なエラー コードを返します。
注釈
通常、ミニドライバーはこの関数を直接呼び出しません。 代わりに、 KsCreateDevice は既定の AddDevice ハンドラー KsAddDevice によって呼び出されます。 KsAddDevice はKsCreateDevice の内部呼び出しを行うため、KsCreateDevice を呼び出すドライバーは KsAddDevice を個別に呼び出さないでください。
KsCreateDevice を直接呼び出すミニドライバーでは、KsInitializeDriver を使用しないでください。 ミニドライバーが KsInitializeDriver を呼び出していない場合は、代わりに独自の AddDevice コールバックを提供する必要があります。 ミニドライバーは、その AddDevice コールバックから KsCreateDevice を呼び出すことができます。
KSDEVICE_DESCRIPTORが指定されていない場合、AVStream は既定の特性を持つデバイスを作成し、関連付けられたフィルター ファクトリは作成しません。 KSDEVICE_DESCRIPTORが指定され、create ディスパッチを含む KSDEVICE_DISPATCH テーブルが含まれている場合は、create dispatch が呼び出されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows XP 以降のオペレーティング システムおよび DirectX 8.0 以降の DirectX バージョンで使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | ks.h (Ks.h を含む) |
| Library | Ks.lib |
| IRQL | PASSIVE_LEVEL |