Recupero di informazioni WDM

[Si applica solo a KMDF]

Il framework fornisce diversi metodi oggetto che consentono al driver di ottenere informazioni definite da WDM.

Recupero di informazioni WDM sul driver e sui relativi dispositivi

Per ottenere informazioni WDM su un driver e sui relativi dispositivi, il driver può chiamare i metodi seguenti:

WdfFdoInitWdmGetPhysicalDevice
Recupera la struttura DEVICE_OBJECT che rappresenta l'oggetto dispositivo fisico di un dispositivo (PDO). Un driver può chiamare questo metodo prima che il driver abbia creato un oggetto dispositivo framework per il dispositivo.

WdfDeviceWdmGetPhysicalDevice
Recupera la struttura di DEVICE_OBJECT WDM che rappresenta l'oggetto PDO di un dispositivo. Un driver può chiamare questo metodo dopo aver creato un oggetto dispositivo framework per il dispositivo.

WdfDeviceWdmGetDeviceObject
Restituisce l'oggetto dispositivo WDM associato a un oggetto dispositivo framework specificato.

WdfDeviceWdmGetAttachedDevice
Restituisce l'oggetto dispositivo WDM inferiore successivo nello stack di dispositivi.

WdfWdmDeviceGetWdfDeviceHandle
Restituisce un handle all'oggetto dispositivo framework associato a un oggetto dispositivo WDM specificato.

WdfWdmDriverGetWdfDriverHandle
Restituisce un handle all'oggetto driver del framework associato a un oggetto driver WDM specificato.

Recupero di informazioni WDM sulle richieste di I/O

Per ottenere informazioni WDM sulle richieste di I/O, un driver può chiamare i metodi seguenti:

WdfRequestWdmGetIrp
Restituisce la struttura IRP WDM associata a un oggetto richiesta framework specificato. D'altra parte, un driver che riceve un IRP WDM all'esterno del framework può creare un oggetto richiesta framework per l'IRP chiamando WdfRequestCreateFromIrp.

WdfRequestGetParameters
Recupera i parametri associati a un oggetto richiesta framework specificato. La maggior parte di questi parametri proviene dalla posizione dello stack I/O WDM della richiesta.

WdfRequestRetrieveOutputWdmMdl
Recupera un elenco di descrittori di memoria (MDL) che rappresenta un buffer di output della richiesta di I/O.

WdfRequestRetrieveInputWdmMdl
Recupera un MDL che rappresenta il buffer di input di una richiesta di I/O.

WdfRequestFormatRequestUsingCurrentType
Copia il contenuto dello stack I/O del driver chiamante nella posizione dello stack di I/O della destinazione I/O locale del driver.

WdfRequestWdmFormatUsingStackLocation
Imposta il contenuto della posizione dello stack di I/O per la destinazione di I/O locale del driver.

Recupero di informazioni WDM sulle destinazioni di I/O

Per ottenere informazioni WDM sulle destinazioni di I/O, un driver può chiamare i metodi seguenti:

WdfIoTargetWdmGetTargetDeviceObject
Restituisce un puntatore all'oggetto dispositivo WDM associato a una destinazione di I/O locale o remota.

WdfIoTargetWdmGetTargetFileObject
Restituisce un puntatore alla struttura di FILE_OBJECT WDM associata a una destinazione di I/O remota.

WdfIoTargetWdmGetTargetFileHandle
Restituisce un handle al file associato a una destinazione di I/O remota.

WdfIoTargetWdmGetTargetPhysicalDevice
Restituisce un puntatore all'oggetto dispositivo fisico WDM (PDO) che rappresenta un dispositivo di destinazione di I/O remoto.

Recupero di informazioni WDM su interruzioni e DPC

Per ottenere informazioni WDM su interruzioni e chiamate di routine posticipate (DPCS), un driver può chiamare i metodi seguenti:

WdfInterruptWdmGetInterrupt
Restituisce un puntatore alla struttura WDM KINTERRUPT associata a un oggetto di interruzione del framework specificato.

WdfDpcWdmGetDpc
Restituisce un puntatore alla struttura WDM KDPC associata a un oggetto DPC del framework specificato.

Recupero di informazioni WDM sulle destinazioni di I/O USB

Per ottenere informazioni WDM sulle destinazioni di I/O USB, un driver può chiamare il metodo seguente:

WdfUsbTargetPipeWdmGetPipeHandle
Restituisce l'handle USBD_PIPE_HANDLE tipizzato associato a un oggetto pipe del framework specificato.

Recupero di informazioni WDM sul Registro di sistema

Per ottenere informazioni WDM sul Registro di sistema, un driver può chiamare il metodo seguente:

WdfRegistryWdmGetHandle
Restituisce un handle WDM alla chiave del Registro di sistema rappresentata da un oggetto chiave del Registro di sistema framework.

Recupero di informazioni WDM sugli oggetti file

Per ottenere informazioni WDM sugli oggetti file, un driver può chiamare il metodo seguente:

WdfFileObjectWdmGetFileObject
Restituisce la struttura wdM FILE_OBJECT associata a un oggetto file framework specificato.