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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX. |
| Piattaforma di destinazione | Desktop |
| Intestazione | ks.h (include Ks.h) |
| IRQL | PASSIVE_LEVEL (vedere la sezione Osservazioni) |