Funzione di callback PFNKSDEVICEPNPSTART (ks.h)
La routine AVStrMiniDeviceStart di un minidriver AVStream viene chiamata quando viene inviata una richiesta di IRP_MN_START_DEVICE per un dispositivo specificato.
Sintassi
PFNKSDEVICEPNPSTART Pfnksdevicepnpstart;
NTSTATUS Pfnksdevicepnpstart(
[in] PKSDEVICE Device,
[in] PIRP Irp,
[in, optional] PCM_RESOURCE_LIST TranslatedResourceList,
[in, optional] PCM_RESOURCE_LIST UntranslatedResourceList
)
{...}
Parametri
[in] Device
Puntatore a una struttura KSDEVICE che descrive il dispositivo da avviare.
[in] Irp
Puntatore al IRP_MN_START_DEVICE ricevuto.
[in, optional] TranslatedResourceList
Puntatore a una struttura CM_RESOURCE_LIST che contiene l'elenco di risorse tradotte estratto da Irp. È uguale a NULL se Device non dispone di risorse assegnate. Opzionale.
[in, optional] UntranslatedResourceList
Puntatore a una struttura CM_RESOURCE_LIST che contiene l'elenco di risorse non tradotte estratto da Irp. È uguale a NULL se il membro KSDEVICE di questo elenco di parametri non dispone di risorse assegnate. Opzionale.
Valore restituito
Deve restituire STATUS_SUCCESS o il codice di errore restituito dal tentativo di eseguire l'operazione. L'avvio ha la certezza di avere esito positivo se la routine restituisce un codice di stato riuscito. Non restituire STATUS_PENDING.
Osservazioni
Specificare l'indirizzo di questa routine nel membro start della relativa struttura di KSDEVICE_DISPATCH.
In genere, questa routine viene usata dai minidriver che devono valutare le risorse assegnate. Gli elenchi di risorse vengono estratti da Irp per praticità del minidriver. Un minidriver può analizzare l'elenco di risorse per trovare l'interrupt assegnato al dispositivo, nonché l'indirizzo fisico delle risorse di memoria.
I minidriver possono usare questa routine per allocare informazioni di contesto da associare al dispositivo AVStream. È simile a un minidriver nella classe stream usando l'estensione del dispositivo per archiviare le informazioni sul contesto.
Si noti che STATUS_PENDING non è un codice restituito legale da questa funzione. Per eseguire azioni nel contesto di un thread di lavoro prima che AVStream abbia completato azioni di avvio, ad esempio l'abilitazione delle interfacce del dispositivo, usare un invio post-avvio. Vedere AVStrMiniDevicePostStart.
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) |