PVIDEO_HW_START_IO fonction de rappel (video.h)

Article
02/07/2025

HwVidStartIO traite le VRP spécifié.

Syntaxe

PVIDEO_HW_START_IO PvideoHwStartIo;

BOOLEAN PvideoHwStartIo(
  PVOID HwDeviceExtension,
  PVIDEO_REQUEST_PACKET RequestPacket
)
{...}

Paramètres

HwDeviceExtension

Pointeur vers la zone de stockage par adaptateur du pilote miniport. Pour plus d’informations, consultez extensions d’appareil.

RequestPacket

Pointeur vers une structure VIDEO_REQUEST_PACKET, qui contient tous les paramètres passés à EngDeviceIoControl.

Valeur de retour

HwVidStartIO doit retourner TRUE, indiquant qu’elle a terminé la requête.

Remarques

Chaque pilote miniport vidéo doit avoir une fonction HwVidStartIO.

Le pilote de port vidéo appelle HwVidStartIO en réponse à chaque requête GDI EngDeviceIoControl, qui provient du pilote d’affichage correspondant. Lorsque HwVidStartIO est appelé, le pilote miniport possède le paquet de demande vidéo d’entrée jusqu’à ce qu’il termine l’opération demandée. HwVidStartIO doivent effectuer les opérations suivantes :

Examinez le membre IoControlCode du VRP pour déterminer l’opération demandée par le pilote d’affichage.
Vérifiez que le VRP InputBufferLength et/ou OutputBufferLength indique une mémoire tampon suffisamment grande pour satisfaire la demande. Le pilote miniport doit retourner une erreur si l’une ou l’autre mémoire tampon est trop petite.
Répondez à la demande.
Définissez les d’état et les membres Information dans le VRP et retournez TRUE.

Le pilote de port vidéo système sérialise toutes les requêtes. Un pilote miniport n’a pas besoin d’effectuer de sérialisation propre, sauf s’il a une fonction HwVidInterrupt.

Toutefois, chaque fonction de HwVidStartIO de chaque pilote miniport doit terminer chaque opération demandée ou définir une erreur appropriée dans l'StatusBlock du VRP avant de retourner le contrôle.

HwVidStartIO doit être rendu paginable.