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 が呼び出されます。

要件

こちらもご覧ください

DEVICE_OBJECT

DRIVER_OBJECT

KSDEVICE

KSDEVICE_DESCRIPTOR

KSDEVICE_DISPATCH

KsAddDevice

KsInitializeDevice

KsInitializeDriver