VideoPortQueryServices, fonction (video.h)
La fonction VideoPortQueryServices expose une interface spécifiée implémentée par le pilote de port vidéo.
Syntaxe
VIDEOPORT_API VP_STATUS VideoPortQueryServices(
[in] IN PVOID HwDeviceExtension,
[in] IN VIDEO_PORT_SERVICES ServicesType,
[in, out] IN OUT PINTERFACE Interface
);
Paramètres
[in] HwDeviceExtension
Pointeur vers l’extension de périphérique du pilote miniport.
[in] ServicesType
Valeur du type énuméré VIDEO_PORT_SERVICES qui spécifie l’interface demandée.
[in, out] Interface
Pointeur vers une structure INTERFACE, qui contient des informations de base sur l’interface demandée. Pour plus d’informations, consultez la section remarques suivantes.
Valeur de retour
Si VideoPortQueryServices réussit, elle retourne NO_ERROR ; sinon, elle retourne un code d’erreur.
Remarques
Si le paramètre ServicesType est défini sur VideoPortServicesI2C, le paramètre Interface doit être un pointeur vers une structure VIDEO_PORT_I2C_INTERFACE, caster en tant que pointeur vers une structure INTERFACE.
De même, si le paramètre ServicesType est défini sur VideoPortServicesAGP, le paramètre Interface doit être un pointeur vers une structure VIDEO_PORT_AGP_INTERFACE ou une structure VIDEO_PORT_AGP_INTERFACE_2, chaque cast en tant que pointeur vers une structure INTERFACE.
Les structures VIDEO_PORT_AGP_INTERFACE et VIDEO_PORT_AGP_INTERFACE_2 sont presque identiques, sauf que cette dernière structure a un membre qui pointe vers la fonction AgpSetRate, qui est utilisée pour réinitialiser le taux de transfert d’un microprogramme AGP. Un pilote de miniport vidéo interrogeant la prise en charge AGP doit appeler VideoPortQueryServices d’abord avec interface pointant vers une structure de VIDEO_PORT_AGP_INTERFACE_2. Si cet appel échoue, le pilote miniport peut ensuite effectuer un autre appel à VideoPortQueryServices, cette fois avec interface pointant vers une structure VIDEO_PORT_AGP_INTERFACE.
Si le paramètre ServicesType est défini sur VideoPortServicesInt10, le paramètre Interface doit être un pointeur vers une structure VIDEO_PORT_INT10_INTERFACE, caster en tant que pointeur vers une structure INTERFACE.
Si le paramètre ServicesType est défini sur VideoPortServicesDebugReport, le paramètre Interface doit être un pointeur vers une structure VIDEO_PORT_DEBUG_REPORT_INTERFACE, casté en tant que pointeur vers une structure INTERFACE.
Si le paramètre ServicesType est défini sur VideoPortServicesWCMemoryProtection, le paramètre Interface doit être un pointeur vers une structure VIDEO_PORT_WCMEMORYPROTECTION_INTERFACE, caster en tant que pointeur vers une structure INTERFACE.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows XP et versions ultérieures des systèmes d’exploitation Windows. |
| plateforme cible | Bureau |
| d’en-tête | video.h (include Video.h) |
| bibliothèque | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |