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呼叫。

此例程是選擇性的。

規格需求

另請參閱

KSDEVICE_DISPATCH