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 (「解説」セクションを参照) |