Fonction de rappel PFNKSDEVICECREATE (ks.h)
La routine AVStrMiniDeviceAdd d’un minidriver AVStream informe le minidriver que la routine AddDevice PnP d’AVStream est terminée.
Syntaxe
PFNKSDEVICECREATE Pfnksdevicecreate;
NTSTATUS Pfnksdevicecreate(
[in] PKSDEVICE Device
)
{...}
Paramètres
[in] Device
Pointeur vers une structure KSDEVICE décrivant l’objet d’appareil fonctionnel (FDO) qui vient d’être créé.
Valeur retournée
Doit retourner STATUS_SUCCESS ou le code d’erreur retourné par la tentative d’exécution de l’opération. Si le minidriver retourne l’échec status, l’appel AddDevice associé échoue également. Pour plus d’informations, consultez la section Remarques ci-dessous.
Remarques
Le minidriver spécifie l’adresse de cette routine dans le membre Ajouter de sa structure KSDEVICE_DISPATCH .
AVStream appelle AVStrMiniDeviceAdd à partir de sa routine AddDevice par défaut, au moment de l’initialisation KSDEVICE . Au moment où cette routine est appelée, l’objet d’appareil WDM (DEVICE_OBJECT) a été créé, la structure KSDEVICE a été instanciée et initialisée, et l’en-tête d’appareil KS a été alloué.
Les minidrivers peuvent utiliser cette routine pour associer des informations de contexte à l’objet d’appareil AVStream ou pour initialiser une extension d’appareil.
Si cette routine retourne un code status infructueux, la routine AddDevice d’AVStream échoue. STATUS_PENDING n’est pas un code de retour légal, car aucun IRP n’est impliqué. La routine est appelée dans IRQL = PASSIVE_LEVEL uniquement.
Cette routine est facultative.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et DirectX 8.0 et versions ultérieures de DirectX. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | ks.h (inclure Ks.h) |
| IRQL | PASSIVE_LEVEL (voir la section Remarques) |