AVC_FUNCTION_FIND_PEER_DO

아티클
06/15/2023

AVC_FUNCTION_FIND_PEER_DO 함수 코드는 비가상 avc.sysinstance 찾습니다.

I/O 상태 블록

성공하면 AV/C 프로토콜 드라이버는 Irp-IoStatus.Status>를 STATUS_SUCCESS 설정합니다.

가능한 다른 반환 값은 다음과 같습니다.

반환 값	Description
STATUS_UNSUCCESSFUL	avc.sys비가상 instance 찾을 수 없습니다.
STATUS_INVALID_GENERATION	디바이스 개체 참조를 찾을 수 있을 때 버스 재설정이 발생했습니다. 새 NodeAddress를 가져오고 다시 시도합니다.

의견

이 함수는 아래와 같이 AVC_MULTIFUNC_IRB 구조체의 PeerLocator 멤버를 사용합니다.

typedef struct _AVC_MULTIFUNC_IRB {
  AVC_IRB  Common;
  union {
    .
    .
    .
    AVC_PEER_DO_LOCATOR PeerLocator;
 .
    .
    .
  };
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;

요구 사항

헤더:avc.h에 선언됩니다. avc.h를 포함합니다.

AVC_MULTIFUNC_IRB 입력

일반
이 멤버의 함수 하위 멤버는 AVC_FUNCTION 열거형에서 AVC_FUNCTION_FIND_PEER_DO 설정해야 합니다.

PeerLocator
avc.sys의 비가상(피어) 인스턴스를 지정합니다.

이 함수는 나타내는 디바이스의 노드 주소에 따라 비가 상avc.sysinstance 찾습니다. instance 찾을 수 없으면 IRP가 STATUS_UNSUCCESSFUL 상태 완료됩니다. instance 있으면 호출자는 개체를 통해 GUID_AVC_CLASS 디바이스 인터페이스 요청을 제출할 수 있습니다. 호출자는 ObDereferenceObject를 통해 이 개체에 대한 참조를 해제해야 합니다.

이 함수 코드는 IRQL <= DISPATCH_LEVEL 호출할 수 있습니다.