Funzione di callback PFNKSDEVICECREATE (ks.h)

Una routine AVStream minidriver AVStrMiniDeviceAdd notifica al minidriver che è stata completata la routine PnP AddDevice di AVStream.

Sintassi

PFNKSDEVICECREATE Pfnksdevicecreate;

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

Parametri

[in] Device

Puntatore a una struttura KSDEVICE che descrive l'oggetto dispositivo funzionale (FDO) appena creato.

Valore restituito

Deve restituire STATUS_SUCCESS o il codice di errore restituito dal tentativo di eseguire l'operazione. Se il minidriver restituisce lo stato di errore, la chiamata AddDevice correlata avrà esito negativo. Per altre informazioni, vedere la sezione Osservazioni riportate di seguito.

Commenti

Il minidriver specifica l'indirizzo di questa routine nel membro Aggiungi della relativa struttura KSDEVICE_DISPATCH .

AVStream chiama AVStrMiniDeviceAdd dalla routine AddDevice predefinita, all'ora di inizializzazione di KSDEVICE. Al momento in cui viene chiamata questa routine, è stato creato l'oggetto dispositivo WDM (DEVICE_OBJECT), la struttura KSDEVICE è stata creata e inizializzata e l'intestazione del dispositivo KS È stata allocata.

I minidriver possono usare questa routine per associare le informazioni di contesto all'oggetto dispositivo AVStream o per inizializzare un'estensione del dispositivo.

Se questa routine restituisce un codice di stato non riuscito, la routine AddDevice di AVStream avrà esito negativo. STATUS_PENDING non è un codice restituito legale perché non è coinvolto alcun IRP. La routine viene chiamata solo in IRQL = PASSIVE_LEVEL.

Questa routine è facoltativa.

Requisiti

Vedi anche

KSDEVICE_DISPATCH