PMINIPORT_GET_REGISTRY_ROUTINE fonction de rappel (video.h)

Article
03/01/2024

HwVidQueryNamedValueCallback traite les données spécifiées récupérées à partir du Registre.

Syntaxe

PMINIPORT_GET_REGISTRY_ROUTINE PminiportGetRegistryRoutine;

VP_STATUS PminiportGetRegistryRoutine(
  PVOID HwDeviceExtension,
  PVOID Context,
  PWSTR ValueName,
  PVOID ValueData,
  ULONG ValueLength
)
{...}

Paramètres

HwDeviceExtension

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

Context

Pointeur vers un contexte déterminé par le pilote spécifié comme entrée de la fonction VideoPortGetRegistryParameters .

ValueName

Pointeur vers une chaîne Unicode terminée par null nommant l’entrée.

ValueData

Pointeur vers les données mises en mémoire tampon associées à ValueName, fournies par VideoPortGetRegistryParameters.

ValueLength

Spécifie la taille en octets de la mémoire tampon dans ValueData.

Valeur retournée

HwVidQueryNamedValueCallback retourne la status de l’opération.

Remarques

HwVidQueryNamedValueCallback est une fonction de pilote miniport facultative passée dans un appel à VideoPortGetRegistryParameters.

VideoPortGetRegistryParameters appelle HwVidQueryNamedValueCallback après avoir collecté les informations de configuration disponibles sur le ValueName donné dans la clé d’adaptateur du Registre.

HwVidFindAdapter ou HwVidInitialize peuvent appeler VideoPortGetRegistryParameters avec une fonction HwVidQueryNamedValueCallback fournie par le pilote, des pointeurs vers l’extension de l’appareil et toutes les données de contexte fournies par le pilote (qui peuvent être la mémoire tampon VIDEO_PORT_CONFIG_INFO ), et un pointeur vers une chaîne Unicode nommant la valeur à récupérer à partir du Registre.

HwVidFindAdapter ou HwVidInitialize peuvent définir l’argument IsFileNameParameters de VideoPortGetRegistryParameters sur TRUE si la chaîne Unicode fournie par le pilote est une entrée de Registre nommée dont la valeur est un nom de fichier. Pour cette spécification, les données retournées seront le contenu du fichier nommé.

Lorsque VideoPortGetRegistryParameters appelle la fonction HwVidQueryNamedValueCallback , il traite toutes les données de configuration mises à disposition. Par exemple, HwVidQueryNamedValueCallback peut utiliser les données récupérées pour déterminer les plages d’accès du pilote miniport et configurer ses plages d’accès de l’émulateur (le cas échéant), interrompre ou interrompre IRQL (le cas échéant), et ainsi de suite dans la mémoire tampon VIDEO_PORT_CONFIG_INFO, ainsi que dans l’extension de périphérique du pilote miniport, avant de renvoyer le contrôle à la fonction HwVidFindAdapter .

HwVidInitialize peut également appeler VideoPortGetRegistryParameters avec IsFileNameParameter défini sur TRUE afin que la fonction HwVidQueryNamedValueCallback fournie par le pilote miniport puisse utiliser le contenu mis en mémoire tampon d’un fichier nommé pour configurer le microcode sur l’adaptateur.

Le ValueData retourné se trouve sur la pile, il peut donc être référencé localement. HwVidQueryNamedValueCallback peut stocker tout ou partie des informations retournées pour une utilisation par d’autres fonctions de pilote miniport dans l’entrée HwDeviceExtension ou utiliser le contexte d’entrée comme pointeur vers un emplacement où les données peuvent être stockées.

HwVidQueryNamedValueCallback doit être rendu paginable.