次の方法で共有


PFNKSDEVICECREATE コールバック関数 (ks.h)

AVStream ミニドライバーの AVStrMiniDeviceAdd ルーチンは、AVStream の PnP AddDevice ルーチンが完了したことをミニドライバーに通知します。

構文

PFNKSDEVICECREATE Pfnksdevicecreate;

NTSTATUS Pfnksdevicecreate(
  [in] PKSDEVICE Device
)
{...}

パラメーター

[in] Device

作成したばかりの機能デバイス オブジェクト (FDO) を記述する KSDEVICE 構造体へのポインター。

戻り値

STATUS_SUCCESSまたは操作の実行試行から返されたエラー コードを返す必要があります。 ミニドライバーがエラー状態を返した場合、関連する AddDevice 呼び出しも失敗します。 詳細については、以下の「備考」セクションを参照してください。

注釈

ミニドライバーは、そのKSDEVICE_DISPATCH構造体の Add メンバーで、このルーチンのアドレスを指定します。

AVStream は、KSDEVICE 初期化時に既定の AddDevice ルーチンから AVStrMiniDeviceAdd を呼び出します。 このルーチンが呼び出される時点で、WDM デバイス オブジェクト (DEVICE_OBJECT) が作成され、 KSDEVICE 構造体がインスタンス化および初期化され、KS デバイス ヘッダーが割り当てられています。

ミニドライバーは、このルーチンを使用して、コンテキスト情報を AVStream デバイス オブジェクトに関連付けたり、デバイス拡張機能を初期化したりできます。

このルーチンが失敗した状態コードを返した場合、AVStream の AddDevice ルーチンは失敗します。 STATUS_PENDINGは、IRP が関係しないため、法的なリターン コードではありません。 ルーチンは IRQL = PASSIVE_LEVEL でのみ呼び出されます。

このルーチンは省略可能です。

要件

要件
サポートされている最小のクライアント Microsoft Windows XP 以降のオペレーティング システムおよび DirectX 8.0 以降の DirectX バージョンで使用できます。
対象プラットフォーム デスクトップ
Header ks.h (Ks.h を含む)
IRQL PASSIVE_LEVEL (「解説」セクションを参照)

こちらもご覧ください

KSDEVICE_DISPATCH