Funzione VideoPortZeroMemory (video.h)

Articolo
03/05/2024

La funzione VideoPortZeroMemory riempie un blocco di memoria di sistema con zero.

Sintassi

VIDEOPORT_API VOID VideoPortZeroMemory(
  [out] PVOID Destination,
        ULONG Length
);

Parametri

[out] Destination

Specifica l'indirizzo iniziale del blocco di memoria. Questo valore deve trovarsi in un intervallo logico mappato restituito da VideoPortGetDeviceBase.

Length

Specifica le dimensioni, in byte, del blocco.

Valore restituito

nessuno

Osservazioni

Le funzioni DriverEntry dei driver miniport chiamano in genere VideoPortZeroMemory per inizializzare la struttura VIDEO_HW_INITIALIZATION_DATA con zero.

La destinazione specificata deve essere in un intervallo logico mappato restituito da VideoPortGetDeviceBase e/o da un indirizzo RAM dello spazio di sistema , ad esempio un indirizzo nello stack. Usare VideoPortZeroDeviceMemory per riempire qualsiasi blocco di memoria del dispositivo, ad esempio un buffer frame, con zero.

Una funzione HwVidInterrupt o HwVidSynchronizeExecutionCallback di un driver miniport può chiamare VideoPortZeroMemory.

I chiamanti di VideoPortZeroMemory possono essere eseguiti in qualsiasi irQL se la memoria puntata dal parametro Destination è nel pool non a pagina. In caso contrario, il chiamante deve essere in esecuzione in irQL < DISPATCH_LEVEL.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	video.h (includere Video.h)
Libreria	Videoprt.lib
DLL	Videoprt.sys
IRQL	Vedere La sezione Osservazioni.