IKsDataTypeCompletion ::KsCompleteMediaType, méthode (ksproxy.h)
La méthode KsCompleteMediaType termine 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érer le filtre KS sous-jacent.
[in] PinFactoryId
Identificateur de la fabrique d’épingles sur laquelle le type de média est terminé.
[in, out] AmMediaType
Pointeur vers une structure AM_MEDIA_TYPE qui décrit le format des exemples multimédias. KsCompleteMediaType reçoit des exemples multimédias partiellement spécifiés, termine la spécification et retourne.
Valeur de retour
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 supports vidéo, dans lesquels le biSizeImage membre 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 type de données peut interroger le filtre KS sous-jacent pour terminer le type de média donné.
Lorsque le proxy crée une instance du gestionnaire de types de données à des fins d’achèvement d’un type de média, le proxy transmet le type de média au IKsDataTypeHandler ::KsSetMediaType méthode pour initialiser ce gestionnaire de types de données vers le type de média particulier.
Pour plus d’informations sur IAMStreamConfig ::SetFormat et AM_MEDIA_TYPE, consultez la documentation du Kit de développement logiciel (SDK) Microsoft Windows.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | ksproxy.h (include Ksproxy.h) |