Função NdisMGetDeviceProperty (ndis.h)
A função NdisMGetDeviceProperty recupera os objetos de dispositivo necessários para configurar a comunicação com um driver de miniporto por meio de um driver de ônibus.
Sintaxe
void NdisMGetDeviceProperty(
[in] NDIS_HANDLE MiniportAdapterHandle,
[out, optional] PDEVICE_OBJECT *PhysicalDeviceObject,
[out, optional] PDEVICE_OBJECT *FunctionalDeviceObject,
[out, optional] PDEVICE_OBJECT *NextDeviceObject,
[out, optional] PCM_RESOURCE_LIST *AllocatedResources,
[out, optional] PCM_RESOURCE_LIST *AllocatedResourcesTranslated
);
Parâmetros
[in] MiniportAdapterHandle
O identificador NDIS que identifica o adaptador de miniporta. Esse identificador foi originalmente passado para o Função MiniportInitializeEx .
[out, optional] PhysicalDeviceObject
Um ponteiro para um buffer alocado pelo chamador. O buffer recebe um ponteiro para uma estrutura DEVICE_OBJECT que representa o dispositivo físico para o adaptador de miniporta. Esse ponteiro é opcional.
[out, optional] FunctionalDeviceObject
Um ponteiro para um buffer alocado pelo chamador. O buffer recebe um ponteiro para uma estrutura DEVICE_OBJECT . DEVICE_OBJECT representa o objeto de dispositivo funcional que o NDIS cria para o dispositivo físico. Esse ponteiro é opcional.
[out, optional] NextDeviceObject
Um ponteiro para um buffer alocado pelo chamador. O buffer recebe um ponteiro para uma estrutura DEVICE_OBJECT que representa o próximo objeto de dispositivo. Esse próximo objeto de dispositivo é precedido na cadeia pelo objeto de dispositivo funcional que pertence ao driver de miniporto. O NDIS cria esse objeto de dispositivo funcional para o dispositivo físico. Por exemplo, o próximo objeto de dispositivo pode ser o objeto associado a um driver de barramento ou HAL Esse ponteiro é opcional.
[out, optional] AllocatedResources
Um ponteiro para um buffer alocado pelo chamador que recebe um ponteiro para uma estrutura CM_RESOURCE_LIST. CM_RESOURCE_LIST descreve uma lista de recursos de hardware que o gerenciador PnP atribui ao dispositivo físico. Esta lista contém os recursos em formato bruto, ou seja, não traduzidos por HAL. Esse ponteiro é opcional.
[out, optional] AllocatedResourcesTranslated
Um ponteiro para um buffer alocado pelo chamador que recebe um ponteiro para uma estrutura CM_RESOURCE_LIST. CM_RESOURCE_LIST descreve uma lista de recursos de hardware que o gerenciador PnP atribui ao dispositivo físico. Essa lista contém os recursos no formato traduzido, ou seja, traduzidos por HAL. Esse ponteiro é opcional.
Retornar valor
Nenhum
Comentários
Os drivers de miniporto devem recuperar informações específicas para configurar suas comunicações. Os drivers de miniporta para instâncias de miniport que se comunicam por meio de drivers de ônibus usam NdisMGetDeviceProperty para recuperar essas informações. Por exemplo, as instâncias de driver de miniporta que se anexam aos barramentos USB (Universal Serial Bus) ou IEEE 1394 exigem drivers de miniporta que expõem uma interface de driver de miniporto NDIS padrão em sua borda superior e usam a interface de classe para o barramento específico em sua borda inferior. Para usar a interface de classe USB ou 1394, um driver de miniporta cria e envia IRPs (Pacotes de Solicitação de E/S). O driver de miniporto usa os objetos físicos e do próximo dispositivo que NdisMGetDeviceProperty recupera para enviar IRPs para a interface de classe de um barramento específico. Para localizar mais informações sobre como criar e enviar IRPs para motoristas de ônibus, consulte Manipulando IRPs.
Ponteiros para DEVICE_OBJECT para os objetos de dispositivo físicos, funcionais e próximos que NdisMGetDeviceProperty recupera são simplesmente alças opacas para o driver de miniporto.
Os drivers de miniport podem chamar NdisMGetDeviceProperty para recuperar ponteiros para recursos "brutos" ou "traduzidos". Os recursos brutos não foram traduzidos pelo HAL; os recursos traduzidos foram. Para localizar mais informações sobre recursos brutos e traduzidos, consulte Plug and Play.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte no NDIS 5.1 e NDIS 6.0 e posterior. Para drivers NDIS 5.1, consulte NdisMGetDeviceProperty (NDIS 5.1). |
| Plataforma de Destino | Universal |
| Cabeçalho | ndis.h (inclua Ndis.h) |
| Biblioteca | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| Regras de conformidade da DDI | Irql_Miniport_Driver_Function(ndis) |