IAMExtTransport ::GetTransportBasicParameters, méthode (strmif.h)

Article
03/04/2024

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La GetTransportBasicParameters méthode récupère les propriétés générales du transport externe.

Syntaxe

HRESULT GetTransportBasicParameters(
  [in]      long     Param,
  [in, out] long     *pValue,
  [in, out] LPOLESTR *ppszData
);

Paramètres

[in] Param

Spécifie la propriété à recevoir.

[in, out] pValue

Pointeur vers une variable qui reçoit une valeur entière longue . Pour plus d'informations, consultez la section Notes.

[in, out] ppszData

Pointeur vers une variable de type LPOLESTR qui reçoit une chaîne. Pour plus d'informations, consultez la section Notes.

Valeur retournée

Lorsque cette méthode réussit, elle retourne S_OK. Sinon, il retourne un code d’erreur HRESULT .

Remarques

Le paramètre Param est un indicateur qui spécifie la propriété à récupérer. Certaines propriétés sont numériques ; elles sont retournées dans le paramètre pValue . Les autres propriétés sont des valeurs de chaîne ; elles sont retournées dans le paramètre ppszData . Pour obtenir la liste des indicateurs et des valeurs attendues, consultez IAMExtTransport ::SetTransportBasicParameters.

Si la méthode retourne une chaîne, l’appelant doit libérer la chaîne à l’aide de la fonction CoTaskMemFree .

Implémentation du caméscope DV et MPEG

MSDV prend en charge les indicateurs supplémentaires suivants :

ED_RAW_EXT_DEV_CMD : appelle une commande AV/C brute. Spécifiez la commande AV/C comme tableau d’octets dans le paramètre ppszData . Spécifiez la taille de la commande, en octets, dans le paramètre pValue . Lorsque la méthode retourne, ppszData contient la réponse de l’appareil et pValue contient la taille de la réponse, en octets. La commande AV/C est passée directement à l’appareil sans validation ni vérification des erreurs.
La charge utile de réponse peut être supérieure à la commande. Il incombe à l’appelant d’allouer suffisamment d’espace dans la mémoire tampon pour la réponse. La taille maximale de la charge utile est de 512 octets.

Pour plus d’informations, consultez Émission de commandes AV/C brutes.

ED_TRANSBASIC_INPUT_SIGNAL : récupère le format de signal que le caméscope DV est conçu pour accepter. Retourne l’une des constantes suivantes dans pValue.

Constant	Description
ED_TRANSBASIC_SIGNAL_525_60_SD	Signal NTSC SD.
ED_TRANSBASIC_SIGNAL_525_60_SDL	Signal SDL NTSC (long-play).
ED_TRANSBASIC_SIGNAL_625_50_SD	Signal PAL SD.
ED_TRANSBASIC_SIGNAL_625_50_SDL	Signal PAL SDL (long-play).
ED_TRANSBASIC_SIGNAL_MPEG2TS	Signal D-VHS.

ED_TRANSBASIC_OUTPUT_SIGNAL : récupère le format de signal que le caméscope DV est conçu pour transmettre. Retourne l’une des constantes répertoriées pour l’indicateur ED_TRANSBASIC_INPUT_SIGNAL.

MSTape prend en charge des valeurs supplémentaires pour ED_TRANSBASIC_INPUT_SIGNAL et ED_TRANSBASIC_OUTPUT_SIGNAL.

Constant	Description
ED_TRANSBASIC_SIGNAL_2500_60_MPEG	Flux MPEG 25 Mbits/s/60.
ED_TRANSBASIC_SIGNAL_1250_60_MPEG	Flux MPEG 12,5 Mbits/s/60.
ED_TRANSBASIC_SIGNAL_0625_60_MPEG	Flux MPEG 6,25 Mbits/s/60.
ED_TRANSBASIC_SIGNAL_2500_50_MPEG	Flux MPEG 25 Mbits/s/50.
ED_TRANSBASIC_SIGNAL_1250_50_MPEG	Flux MPEG de 12,5 Mbits/s/50.
ED_TRANSBASIC_SIGNAL_0625_50_MPEG	Flux MPEG 6,25 Mbits/s/50.
ED_TRANSBASIC_SIGNAL_UNKNOWN	Format de signal inconnu.

Ces indicateurs sont définis dans le fichier d’en-tête Xprtdefs.h.

Dans Windows XP Service Pack 2 et versions ultérieures, les types de signal supplémentaires suivants sont définis pour les indicateurs ED_TRANSBASIC_INPUT_SIGNAL et ED_TRANSBASIC_OUTPUT_SIGNAL.

Constant	Description
ED_TRANSBASIC_SIGNAL_525_60_DV25	DVCPRO 25, 525-60.
ED_TRANSBASIC_SIGNAL_625_50_DV25	DVCPRO 25, 625-50.
ED_TRANSBASIC_SIGNAL_525_60_DV50	DVCPRO 50, 525-60.
ED_TRANSBASIC_SIGNAL_625_50_DV50	DVCPRO 50, 625-50.
ED_TRANSBASIC_SIGNAL_HD_60_DVH1	DVCPRO 100, 1080i ou 720p
ED_TRANSBASIC_SIGNAL_HD_50_DVH1	DVCPRO 100, 1080i uniquement

Pour utiliser ces constantes, incluez le fichier d’en-tête Xprtdefs.h du SDK Windows.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IAMExtTransport, interface

Partager via