Partager via

KsAcquireCachedMdl, fonction (ks.h)

  • Article

Cette fonction est utilisée pour acquérir le MDL mis en cache par le pilote de port KS. La fonction est utilisée par un pilote en mode noyau pour acquérir le MDL pour un exemple fourni par un pipeline généré par un pilote Avstream.

Syntaxe

KSDDKAPI NTSTATUS KsAcquireCachedMdl(
  PIRP                 Irp,
  REFGUID              Guid,
  PFNKSCANCELPINNEDMDL CancelRoutine,
  PVOID                CancelContext,
  PMDL                 *MdlAddr,
  PVOID                *ReleaseContext
);

Paramètres

Irp

IRP transmis à partir du mode utilisateur contenant l’exemple de mémoire tampon en mode utilisateur.

Guid

GUID extrait de l’élément d’attribut MFSampleExtension_MDLCacheCookie du IMFSample passé par le pipeline.

CancelRoutine

Annuler la routine, une fonction de rappel fournie par le pilote miniport Avstream. Cette fonction est appelée lorsque l’état de la broche générant l’exemple passe à l’état STOP. La signature de la routine d’annulation est la suivante :

_IRQL_requires_max_(DISPATCH_LEVEL)
typedef
VOID
(*PFNKSCANCELPINNEDMDL)(
    _In_ GUID,
    _In_ PVOID,
    _In_ PVOID
);

GUID
GUID transmis dans la fonction KsAcquireCachedMdl par le pilote miniport Avstream.

PVOID
Annuler le contexte fourni par le pilote miniport Avstream dans l’appel de fonction KsAcquireCachedMdl.

PVOID
Contexte de mise en production. Il s’agit de la sortie de la fonction KsAcquireCachedMdl.

CancelContext

Contexte passé au pilote Avstream dans la routine d’annulation. Ce contexte est utilisé par le pilote Avstream pour accéder au contexte du pilote.

MdlAddr

Valeur de retour : MDL résultant si KS trouve le MDL stocké pour l’exemple de mémoire tampon.

ReleaseContext

Valeur de retour : contexte à stocker par le pilote Avstream. Ce contexte doit être transmis à KS lors de la publication du MDL acquis par l’appel KsAcquireCachedMdl.

Valeur de retour

Retourne STATUS_SUCCESS pour les conditions de réussite.

Exigences

Exigence Valeur
plateforme cible Universel
d’en-tête ks.h (include Ks.h)
bibliothèque Ks.lib