Função WdfFdoInitWdmGetPhysicalDevice (wdffdo.h)

  • Artigo

[Aplica-se somente ao KMDF]

O método WdfFdoInitWdmGetPhysicalDevice recupera o PDO (objeto de dispositivo físico) WDM de um dispositivo.

Sintaxe

PDEVICE_OBJECT WdfFdoInitWdmGetPhysicalDevice(
  [in] PWDFDEVICE_INIT DeviceInit
);

Parâmetros

[in] DeviceInit

Um ponteiro para uma estrutura WDFDEVICE_INIT que o driver obteve de sua função de retorno de chamada EvtDriverDeviceAdd .

Retornar valor

Se a operação for bem-sucedida, o método retornará um ponteiro para uma estrutura DEVICE_OBJECT . Caso contrário, o método retornará NULL.

Comentários

O driver deve chamar WdfFdoInitWdmGetPhysicalDevice antes de chamar WdfDeviceCreate. Para obter mais informações sobre como chamar WdfDeviceCreate, consulte Criando um objeto de dispositivo framework.

Para obter mais informações sobre o método WdfFdoInitWdmGetPhysicalDevice , consulte Criando objetos de dispositivo em um driver de função.

Exemplos

O exemplo de código a seguir obtém um ponteiro para uma estrutura DEVICE_OBJECT que representa o PDO do WDM de um dispositivo.

PDEVICE_OBJECT device;

device = WdfFdoInitWdmGetPhysicalDevice(DeviceInit);

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Cabeçalho wdffdo.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL <= DISPATCH_LEVEL
Regras de conformidade de DDI DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)