PFNKSDEVICECREATE 回呼函式 (ks.h)
AVStream minidriver 的 AVStrMiniDeviceAdd 例程會通知 AVStream 的 PnP AddDevice 例程已完成。
語法
PFNKSDEVICECREATE Pfnksdevicecreate;
NTSTATUS Pfnksdevicecreate(
[in] PKSDEVICE Device
)
{...}
參數
[in] Device
KSDEVICE 結構的指標,描述剛建立 (FDO) 的功能裝置物件。
傳回值
應該傳回STATUS_SUCCESS或從嘗試執行作業傳回的錯誤碼。 如果 minidriver 傳回失敗狀態,相關的 AddDevice 呼叫也會失敗。 如需詳細資訊,請參閱下方的一節。
備註
minidriver 會在其KSDEVICE_DISPATCH結構的 Add 成員中指定此例程的位址。
AVStream 會在 KSDEVICE 初始化時間從其預設 AddDevice 例程呼叫 AVStrMiniDeviceAdd。 在呼叫此例程時,已建立 (DEVICE_OBJECT) 的 WDM 裝置物件、已具現化和初始化 KSDEVICE 結構,以及已設定 KS 裝置標頭。
Minidrivers 可以使用這個例程,將內容資訊與 AVStream 裝置對象產生關聯,或初始化裝置延伸模組。
如果此例程傳回失敗的狀態代碼,AVStream 的 AddDevice 例程將會失敗。 STATUS_PENDING不是合法的傳回碼,因為沒有涉及 IRP。 例程只會在 IRQL = PASSIVE_LEVEL呼叫。
此例程是選擇性的。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Microsoft Windows XP 和更新版本的作業系統和 DirectX 8.0 和更新版本的 DirectX 版本。 |
目標平台 | 桌面 |
標頭 | ks.h (包含 Ks.h) |
IRQL | PASSIVE_LEVEL (请参阅一节) |