Função WdfDriverWdmGetDriverObject (wdfdriver.h)
[Aplica-se somente ao KMDF]
O método WdfDriverWdmGetDriverObject recupera um ponteiro para o objeto de driver WDM (Modelo de Driver do Windows) associado a um objeto de driver de estrutura especificado.
Sintaxe
PDRIVER_OBJECT WdfDriverWdmGetDriverObject(
[in] WDFDRIVER Driver
);
Parâmetros
[in] Driver
Um identificador para o objeto de driver de estrutura do driver que o driver obteve de uma chamada anterior para WdfDriverCreate ou WdfGetDriver.
Retornar valor
WdfDriverWdmGetDriverObject retorna um ponteiro para uma estrutura DRIVER_OBJECT . Um bug do sistema marcar ocorrerá se o identificador do Driver for inválido.
Comentários
O ponteiro que o método WdfDriverWdmGetDriverObject retorna é válido até que o objeto do driver da estrutura seja excluído. Se o driver fornecer uma função EvtCleanupCallback para o objeto de driver da estrutura, o ponteiro será válido até que a função de retorno de chamada retorne.
Exemplos
O exemplo de código a seguir obtém um ponteiro para o objeto de driver WDM associado a um objeto de driver de estrutura especificado.
PDRIVER_OBJECT pDrvObj;
pDrvObj = WdfDriverWdmGetDriverObject(Driver);
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.0 |
| Cabeçalho | wdfdriver.h (inclua Wdf.h) |
| Biblioteca | Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.) |
| IRQL | <= DISPATCH_LEVEL |
| Regras de conformidade de DDI | DriverCreate(kmdf) |