VideoPortQueryServices, fonction (video.h)

Article
03/01/2024

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 VIDEO_PORT_SERVICES type énuméré 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 suivante.

Valeur retournée

Si VideoPortQueryServices réussit, il 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 , cast 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 , chacun 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 pour un chipset AGP. Un pilote de miniport vidéo interrogeant la prise en charge AGP doit d’abord appeler VideoPortQueryServices avec l’interface pointant vers une structure 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 , cast 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 , cast en tant que pointeur vers une structure INTERFACE.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows XP et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	video.h (incluez Video.h)
Bibliothèque	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL