Méthode IKsDataTypeCompletion ::KsCompleteMediaType (ksproxy.h)

La méthode KsCompleteMediaType complète un type de média partiellement spécifié qui a d’abord été présenté à la méthode IAMStreamConfig ::SetFormat .

Syntaxe

HRESULT KsCompleteMediaType(
  [in]      HANDLE        FilterHandle,
  [in]      ULONG         PinFactoryId,
  [in, out] AM_MEDIA_TYPE *AmMediaType
);

Paramètres

[in] FilterHandle

Gérez le filtre KS sous-jacent.

[in] PinFactoryId

Identificateur de la fabrique de broches sur laquelle le type de média est en cours d’exécution.

[in, out] AmMediaType

Pointeur vers une structure AM_MEDIA_TYPE qui décrit le format des exemples multimédias. KsCompleteMediaType reçoit des exemples de médias partiellement spécifiés, termine la spécification et retourne.

Valeur retournée

Retourne NOERROR si le type de média a réussi et que le type de média a été terminé ; sinon, retourne un code d’erreur.

Remarques

La méthode KsCompleteMediaType est principalement utilisée pour les types de médias vidéo, dans lesquels le membre biSizeImage de la structure KS_BITMAPINFOHEADER est connu uniquement du pilote, en raison des formats de compression privés pris en charge. Si nécessaire, le gestionnaire de types de données peut interroger le filtre KS sous-jacent afin d’effectuer le type de média donné.

Lorsque le proxy crée une instance du gestionnaire de types de données pour terminer un type de média, le proxy transmet le type de média à la méthode IKsDataTypeHandler ::KsSetMediaType pour initialiser d’abord ce gestionnaire de type de données sur le type de média particulier.

Pour plus d’informations sur IAMStreamConfig ::SetFormat et AM_MEDIA_TYPE, consultez la documentation Microsoft Windows SDK.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	ksproxy.h (inclure Ksproxy.h)

Voir aussi

IKsDataTypeHandler ::KsSetMediaType

KS_BITMAPINFOHEADER