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

Voir aussi

KSDEVICE_DISPATCH