Funzione di callback PFNKSDEVICECREATE (ks.h)
Una routine AVStrMiniDeviceAdd notifica al minidriver che la routine PnP di AVStream AddDevice completata.
Sintassi
PFNKSDEVICECREATE Pfnksdevicecreate;
NTSTATUS Pfnksdevicecreate(
[in] PKSDEVICE Device
)
{...}
Parametri
[in] Device
Puntatore a una struttura KSDEVICE che descrive l'oggetto dispositivo funzionale 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, anche la chiamata AddDevice correlata avrà esito negativo. Per altri dettagli, vedere la sezione Osservazioni di seguito.
Osservazioni
Il minidriver specifica l'indirizzo di questa routine nel Aggiungi membro della relativa struttura di KSDEVICE_DISPATCH.
AVStream chiama AVStrMiniDeviceAdd dalla routine AddDevice predefinita KSDEVICE tempo di inizializzazione. Nel momento in cui viene chiamata questa routine, è stato creato l'oggetto dispositivo WDM (DEVICE_OBJECT), la struttura KSDEVICE è stata creata un'istanza 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Microsoft Windows XP e nei sistemi operativi successivi e in 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) |