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) |