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

[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.

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.

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

Configuration requise

Voir aussi

Codes d’erreur et de réussite

IAMExtTransport, interface