Funzione VideoPortRegisterBugcheckCallback (video.h)

La funzione VideoPortRegisterBugcheckCallback consente a un driver miniport video di registrarsi per, o hook, un callback richiamato quando si verifica un controllo di bug specificato.

Sintassi

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortRegisterBugcheckCallback(
  [in] IN PVOID                    HwDeviceExtension,
  [in] IN ULONG                    BugcheckCode,
  [in] IN PVIDEO_BUGCHECK_CALLBACK Callback,
  [in] IN ULONG                    BugcheckDataSize
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo del driver miniport.

[in] BugcheckCode

Indica il codice di controllo del bug per il quale eseguire il richiamato. Attualmente, il driver miniport può registrarsi solo per il codice di controllo dei bug 0xEA.

[in] Callback

Puntatore alla funzione HwVidBugcheckCallback del driver miniport. Questa funzione deve essere non di paging e non deve fare riferimento a codice o dati di paging. Il driver miniport può impostare questo parametro su NULL per indicare che il callback del controllo bug deve essere scollegato.

[in] BugcheckDataSize

Indica la somma di BUGCHECK_DATA_SIZE_RESERVED e il numero di byte di dati che il driver miniport fornirà per l'inclusione nel file di dump. Il valore di questo parametro deve essere minore o uguale a 4000. Il driver miniport può impostare questo parametro su zero per indicare che il callback di controllo dei bug deve essere scollegato.

Valore restituito

VideoPortRegisterBugcheckCallback restituisce NO_ERROR se ha esito positivo. In caso contrario, restituisce un codice di stato che indica la natura dell'errore.

Commenti

Se si sviluppa un driver miniport video destinato all'esecuzione in Windows XP o in un sistema operativo nt-base precedente, è possibile utilizzare la routine di callback VideoPortGetProcAddress per trovare l'indirizzo della funzione VideoPortRegisterBugcheckCallback . Per informazioni dettagliate, vedere Uso di VideoPortGetProcAddress.

Un driver miniport può registrarsi per un callback quando si verifica un tipo specifico di controllo dei bug. Attualmente è possibile associare solo il codice di controllo dei bug 0xEA . Quando si verifica il controllo dei bug, viene chiamata la funzione di callback fornita dal minidriver e il driver miniport può aggiungere dati al file di dump. Ciò è utile per raccogliere dati statistici quando il debug diretto non è possibile.

Il valore del parametro BugcheckDataSize deve essere BUGCHECK_DATA_SIZE_RESERVED byte maggiori dei dati forniti dal driver miniport. Si supponga, ad esempio, che il driver miniport fornisca DUMP_SIZE byte di dati da scrivere nel file di dump. Il valore di BugcheckDataSize deve quindi essere DUMP_SIZE + BUGCHECK_DATA_SIZE_RESERVED e tale valore totale deve essere minore o uguale a 4000.

La costante BUGCHECK_DATA_SIZE_RESERVED (definita in video.h) è disponibile negli ambienti di compilazione di Microsoft Windows Server 2003 e versioni successive. Nell'ambiente di compilazione di Windows XP SP1 usare 48 anziché BUGCHECK_DATA_SIZE_RESERVED.

Il driver miniport può annullare la registrazione di un callback registrato in precedenza chiamando questa funzione, specificando NULL per il parametro Callback o zero per il parametro DataSize .

Per altre informazioni, vedere Video Port Driver Support for Bug Check Callbacks .For more information, see Video Port Driver Support for Bug Check Callbacks.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows XP SP1 e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	video.h (include Video.h)
Libreria	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

Vedi anche

HwVidBugcheckCallback