PVIDEO_HW_START_IO fonction de rappel (video.h)

Article
02/27/2024

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 initialement passés à EngDeviceIoControl.

Valeur retournée

HwVidStartIO doit retourner TRUE, indiquant qu’il a terminé la demande.

Remarques

Chaque pilote de 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 est propriétaire du paquet de requête vidéo d’entrée jusqu’à ce qu’il termine l’opération demandée. HwVidStartIO doit 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 les entrées VRP InputBufferLength et/ou OutputBufferLength indiquent une mémoire tampon suffisamment grande pour répondre à la demande. Le pilote miniport doit retourner une erreur si l’une des mémoires tampons est trop petite.
Répondez à la demande.
Définissez les membres Status et 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 une sérialisation de son propre, sauf s’il a une fonction HwVidInterrupt .

Toutefois, la fonction HwVidStartIO de chaque pilote miniport doit terminer chaque opération demandée ou définir une erreur appropriée dans statusBlock du VRP avant qu’elle ne retourne le contrôle.

HwVidStartIO doit être rendu paginable.