PMINIPORT_GET_REGISTRY_ROUTINE funzione di callback (video.h)

Articolo
02/07/2025

HwVidQueryNamedValueCallback elabora i dati specificati recuperati dal Registro di sistema.

Sintassi

PMINIPORT_GET_REGISTRY_ROUTINE PminiportGetRegistryRoutine;

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

Parametri

HwDeviceExtension

Puntatore all'area di archiviazione per adattatore del driver miniport. Per altre informazioni, vedere Device Extensions.

Context

Puntatore a un contesto determinato dal driver specificato come input per la funzione videoPortGetRegistryParameters.

ValueName

Puntatore a una stringa Unicode con terminazione NULL che denomina la voce.

ValueData

Puntatore ai dati memorizzati nel buffer associati a ValueName, forniti da VideoPortGetRegistryParameters.

ValueLength

Specifica le dimensioni in byte del buffer in ValueData.

Valore restituito

HwVidQueryNamedValueCallback restituisce lo stato dell'operazione.

Osservazioni

HwVidQueryNamedValueCallback è una funzione driver miniport facoltativa passata in una chiamata a VideoPortGetRegistryParameters.

VideoPortGetRegistryParameters chiama HwVidQueryNamedValueCallback dopo aver raccolto informazioni di configurazione disponibili sul ValueName specificato nell'adattatore chiave del Registro di sistema.

HwVidFindAdapter o HwVidInitialize può chiamare VideoPortGetRegistryParameters con un driver fornito funzione HwVidQueryNamedValueCallback, puntatori all'estensione del dispositivo e a tutti i dati di contesto forniti dal driver (che possono essere il buffer VIDEO_PORT_CONFIG_INFO) e un puntatore a una stringa Unicode che denomina il valore da recuperare dal Registro di sistema.

HwVidFindAdapter o HwVidInitialize può impostare VideoPortGetRegistryParameters's IsFileNameParameter argomento per TRUE se la stringa Unicode fornita dal driver è una voce del Registro di sistema denominata il cui valore è un nome file. Per questa specifica, i dati restituiti saranno il contenuto del file denominato.

Quando VideoPortGetRegistryParameters chiama la funzione HwVidQueryNamedValueCallback, elabora i dati di configurazione disponibili. Ad esempio, HwVidQueryNamedValueCallback potrebbe usare i dati recuperati per determinare gli intervalli di accesso del driver miniport e configurare gli intervalli di accesso dell'emulatore (se presenti), il vettore di interrupt o l'interrupt IRQL (se presente) e così via nel buffer VIDEO_PORT_CONFIG_INFO, nonché nell'estensione del dispositivo del driver miniport, prima di restituire il controllo alla funzione HwVidFindAdapter.

HwVidInitialize potrebbe anche chiamare VideoPortGetRegistryParameters con IsFileNameParameter impostato su TRUE in modo che il driver miniport fornito HwVidQueryNamedValueCallback funzione potrebbe usare il contenuto memorizzato nel buffer di un file denominato per configurare il microcodice nell'adattatore.

L'oggetto restituito ValueData si trova nello stack, in modo che possa essere fatto riferimento in locale. HwVidQueryNamedValueCallback può archiviare alcune o tutte le informazioni restituite per l'uso da parte di altre funzioni driver miniport nell'input HwDeviceExtension o usare l'input Context come puntatore a una posizione in cui è possibile archiviare i dati.

HwVidQueryNamedValueCallback deve essere reso pageable.