PMINIPORT_GET_REGISTRY_ROUTINE funzione di callback (video.h)

Articolo
02/29/2024

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 Estensioni del dispositivo.

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.

Commenti

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

VideoPortGetRegistryParameters chiama HwVidQueryNamedValueCallback dopo aver raccolto informazioni di configurazione disponibili sul valore valore specificato nella chiave dell'adapter del Registro di sistema.

HwVidFindAdapter o HwVidInitialize può chiamare VideoPortGetRegistryParameters con una 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.

L'argomento HwVidFindAdapter o HwVidInitialize può impostare l'argomento IsFileNameParameters di VideoPortGetRegistryParameters su 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 resi disponibili. Ad esempio, HwVidQueryNamedValueCallback può usare i dati recuperati per determinare gli intervalli di accesso del driver miniport e per configurare gli intervalli di accesso dell'emulatore (se presenti), il vettore di interruzione o l'interruzione di 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 la funzione HwVidQueryNamedValueCallback fornita dal driver miniport possa usare il contenuto memorizzato nel buffer di un file denominato per configurare microcode sulla scheda.

Il valore restituito è nello stack, quindi può essere fatto riferimento in locale. HwVidQueryNamedValueCallback può archiviare alcune o tutte le informazioni restituite per l'uso da altre funzioni del driver miniport nell'input HwDeviceExtension o usare il contesto di input come puntatore a una posizione in cui è possibile archiviare i dati.

HwVidQueryNamedValueCallback deve essere reso paginabile.