Méthode CSourceStream.QueryId
[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 QueryId méthode récupère un identificateur pour la broche.
Syntaxe
HRESULT QueryId(
LPWSTR *Id
);
Paramètres
-
Id
-
Pointeur vers une variable qui reçoit une chaîne contenant l’identificateur de broche.
Valeur renvoyée
Retourne une valeur HRESULT . Les valeurs possibles incluent celles indiquées dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
Opération réussie. |
|
Mémoire insuffisante. |
|
Argument pointeur NULL . |
|
Épingle introuvable sur le filtre. |
Notes
Cette méthode implémente la méthode IPin::QueryId . Pour construire une chaîne d’identificateur, la broche appelle la méthode CSource::FindPinNumber avec elle-même comme paramètre. La méthode FindPinNumber retourne le numéro d’épingle, indexé à partir de zéro.
QueryId incrémente la valeur de retour d’un seul et convertit le résultat en chaîne. Par exemple, la première broche devient « 1 » ; la deuxième broche devient « 2 » ; et ainsi de suite.
Si cette méthode retourne VFW_E_NOT_FOUND, cela indique que le tableau de broches du filtre n’est pas valide, probablement dû à un bogue dans le filtre.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|