Método IPort::GetDeviceProperty (portcls.h)

O método GetDeviceProperty fornece acesso simplificado às propriedades do dispositivo contidas no registro para dispositivos Plug and Play.

Sintaxe

NTSTATUS GetDeviceProperty(
  DEVICE_REGISTRY_PROPERTY DeviceProperty,
  ULONG                    BufferLength,
  PVOID                    PropertyBuffer,
  PULONG                   ResultLength
);

Parâmetros

DeviceProperty

Identifica a propriedade de dispositivo específica que o chamador está solicitando. Os valores válidos para esse parâmetro são os mesmos definidos para o parâmetro DeviceProperty da chamada IoGetDeviceProperty.

BufferLength

Especifica o comprimento em bytes do buffer que deve receber as informações solicitadas.

PropertyBuffer

Ponteiro para o buffer de propriedades. Esse parâmetro aponta para um buffer alocado pelo chamador no qual o método grava as informações de propriedade solicitadas. O buffer deve ser grande o suficiente para conter o número de bytes especificados em BufferLength.

ResultLength

Ponteiro de saída para o comprimento dos dados retornados. Esse parâmetro aponta para uma variável ULONG alocada pelo chamador na qual o método grava uma contagem especificando o número de bytes realmente gravados no buffer PropertyBuffer. No entanto, se o buffer for muito pequeno para conter as informações, o método gerará o tamanho do buffer necessário.

Retornar valor

Esse método retorna NTSTATUS que contém STATUS_SUCCESS se a chamada foi bem-sucedida. Caso contrário, o método retorna um código de erro apropriado. Se o buffer de propriedade fornecido pelo chamador for muito pequeno, o método retornará STATUS_BUFFER_TOO_SMALL e produzirá o tamanho necessário em ReturnLength.

Comentários

Esse método recupera as propriedades do dispositivo do adaptador de áudio. Ele é semelhante em operação à função PcGetDeviceProperty, exceto que recupera automaticamente as propriedades do dispositivo do adaptador de áudio em vez de exigir que um objeto de dispositivo especifique explicitamente um dispositivo de destino.

Requisitos

Requisito	Valor
Cabeçalho	portcls.h
IRQL	PASSIVE_LEVEL

Confira também

Iport